A simple class that allows to count lines while iterating over a string
This module helps you when you want to output the line-number of certain locations in a string while iterating over the string otherwise. For example, if you want to
Suppose, we want to extract all occurences of 'sed' and 'ipsum' from the following text:
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor
invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et
accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata
sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing
elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed
diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd
gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.We can easily match all the occurences with a regex, but we only get the char-index of each match.
Using the line-counter module, we can print line-numbers as well:
var regex = /sed|ipsum/g;
var text = require("fs").readFileSync("example.txt");
var LineCounter = require("line-counter");
var counter = new LineCounter(text);
var match;
while ((match = regex.exec(text)) !== null) {
// Example for .countUpTo()
console.log(
"Found '" + match[0] + "'",
"at index", match.index,
"which is in line ", counter.countUpTo(match.index)
);
// Example for .locate()
console.log(
"Found '" + match[0] + "'",
"at index", match.index,
"which is at location", counter.locate(match.index)
);
}Create a new LineCounter instance counting lines in a given string. The class provides a method countUpTo that pushes an internal counter to the line of a specified char-index in the string.
Example:
Params
contents{string}: the string that is parsed (i.e. file contents)
Example
var LineCounter = require('line-counter');
var lc = new LineCounter('abc\ncde\nefg');
lc.countUpTo(0); // == 1
lc.countUpTo(8); // == 3Returns the line-number of a given char-index within the string.
Params
upTo{number}: a char-index within thecontents-string. This char-index must be greater or equal to the line-start of the last char-index passed to the previous call tocountUpToreturns{number}: the line-number of this char-index.
Returns the location (line-nr and column-nr) of a char index within the string.
returns{{column: number, line: number}: line- and column-index (based off1)
Install dev dependencies:
$ npm i -d && npm testPull requests and stars are always welcome. For bugs and feature requests, please create an issue
Nils Knappmeier
Released under the MIT license.
This project adheres to Semantic Versioning.
- Added
.locate(charIndex)to return line- and column-index of the char-index location
- Issue #1: Endless-Loop calling
.upTo(content.length)for contents that end with a new-line.
- Initial version of the line-counter module