README
substringBefore
Return the part of a string before a specified substring.
Installation
npm install @stdlib/string-substring-before
Usage
var substringBefore = require( '@stdlib/string-substring-before' );
substringBefore( str, search )
Returns the part of a string before a specified substring.
var str = 'beep boop';
var out = substringBefore( str, ' ' );
// returns 'beep'
out = substringBefore( str, 'o' );
// returns 'beep b'
Notes
- If a substring is not present in a provided string, the function returns the input string.
- If provided an empty substring, the function returns an empty string.
Examples
var substringBefore = require( '@stdlib/string-substring-before' );
var out = substringBefore( 'beep boop', 'p' );
// returns 'bee'
out = substringBefore( 'Hello World!', 'xyz' );
// returns 'Hello World!'
out = substringBefore( 'Hello World!', '' );
// returns ''
out = substringBefore( '', 'xyz' );
// returns ''
CLI
Installation
To use the module as a general utility, install the module globally
npm install -g @stdlib/string-substring-before
Usage
Usage: substring-before [options] --search=<string> [<string>]
Options:
-h, --help Print this message.
-V, --version Print the package version.
--search string Search string.
--split sep Delimiter for stdin data. Default: '/\\r?\\n/'.
Notes
If the split separator is a regular expression, ensure that the
split
option is either properly escaped or enclosed in quotes.# Not escaped... $ echo -n