vfile-location
vfile utility to convert between positional (line and column-based) and offset (range-based) locations
Last updated 5 years ago by wooorm .
MIT · Repository · Bugs · Original npm
$ cnpm install vfile-location 
SYNC missed versions from official npm registry.

vfile-location

Build Coverage Downloads Size Sponsors Backers Chat

Convert between positional (line and column-based) and offsets (range-based) locations in a virtual file.

Install

npm:

npm install vfile-location

Use

var vfile = require('vfile')
var vfileLocation = require('vfile-location')

var location = vfileLocation(vfile('foo\nbar\nbaz'))

var offset = location.toOffset({line: 3, column: 3}) // => 10
location.toPoint(offset) // => {line: 3, column: 3, offset: 10}

API

location = vfileLocation(doc)

Get transform functions for the given doc (string) or file.

Returns an object with toOffset and toPoint.

location.toOffset(point)

Get the offset (number) for a line and column-based point in the bound file. Returns -1 when given invalid or out of bounds input.

location.toPoint(offset)

Get the line and column-based point for offset in the bound file.

Contribute

See contributing.md in vfile/.github for ways to get started. See support.md for ways to get help.

This project has a code of conduct. By interacting with this repository, organization, or community you agree to abide by its terms.

License

MIT © Titus Wormer

Current Tags

  • 5.0.1                                ...           latest (2 years ago)

8 Versions

  • 5.0.1                                ...           2 years ago
  • 2.0.4                                ...           7 years ago
  • 3.2.0                                ...           5 years ago
  • 4.0.1                                ...           4 years ago
  • 3.1.0                                ...           5 years ago
  • 2.0.5                                ...           6 years ago
  • 2.0.6                                ...           6 years ago
  • 3.0.1                                ...           5 years ago
Maintainers (1)
Downloads
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (0)
None
Dev Dependencies (11)
Dependents (0)
None

Copyright 2013 - present © cnpmjs.org