/string-split-by

Split a string on a given character or characters, with support for escaping.

Primary LanguageJavaScript

string-split-by unstable Build Status

Split string by a separator with respect to brackets, quotes and escape markers. Optimized version of string-split.

Usage

npm install string-split-by

var split = require('string-split-by')

split('a."b.c".d.{.e.f.g.}.h', '.')
// ['a', '"b.c"', 'd', '{.e.f.g.}', 'h']

split('a."b.c".d.{.e.f.g.}.h', '.', {ignore: '""'})
// ['a', '"b.c"', 'd', '{', 'e', 'f', 'g', '}', 'h']

API

parts = splitBy(string, separator, options?)

Return array with parts split from string by a separator, which can be whether String or RegExp. Options can define:

Option Default Meaning
ignore ['"', "'", '`', '“”', '«»', '[]', '()', '{}'] Avoid splitting content enclosed in the character pairs. Can be a string or a list of strings.
escape true Avoid splitting at the escaped separator, eg. \. won't be separated by '.' separator.

Related

License

© 2018 Dmitry Yv. MIT License