# substringAfter
> Return the part of a string after a specified substring.
## Usage
```javascript
var substringAfter = require( '@stdlib/string/substring-after' );
```
#### substringAfter( str, search\[, fromIndex] )
Returns the part of a string after a specified substring.
```javascript
var str = 'beep boop';
var out = substringAfter( str, 'o' );
// returns 'op'
out = substringAfter( str, ' ' );
// returns 'boop'
```
By default, the search starts at the beginning of the string. To start searching from a different index, provide a `fromIndex` argument:
```javascript
var str = 'boop baz boop';
var out = substringAfter( str, 'o', 3 );
// returns 'op'
```
## Notes
- If a substring is not present in a provided string, the function returns an empty string.
- If provided an empty substring, the function returns the input string.
- If `fromIndex` is less than `0` or greater than `str.length`, the search starts at index `0` and `str.length`, respectively.
## Examples
```javascript
var substringAfter = require( '@stdlib/string/substring-after' );
var str = 'To be, or not to be, that is the question.';
var out = substringAfter( str, ', ' );
// returns 'or not to be, that is the question.'
out = substringAfter( str, 'to be' );
// returns ', that is the question.'
out = substringAfter( str, 'question.' );
// returns ''
out = substringAfter( str, 'xyz' );
// returns ''
out = substringAfter( str, '' );
// returns 'To be, or not to be, that is the question.'
```
* * *
## CLI
### Usage
```text
Usage: substring-after [options] --search= []
Options:
-h, --help Print this message.
-V, --version Print the package version.
--search string Search string.
--from-index int Start index. Default: 0.
--split sep Delimiter for stdin data. Default: '/\\r?\\n/'.
```
### Notes
- If the split separator is a [regular expression][mdn-regexp], ensure that the `split` option is either properly escaped or enclosed in quotes.
```bash
# Not escaped...
$ echo -n $'foo\nbar\nbaz' | substring-after --search a --split /\r?\n/
# Escaped...
$ echo -n $'foo\nbar\nbaz' | substring-after --search a --split /\\r?\\n/
```
- The implementation ignores trailing delimiters.
### Examples
```bash
$ substring-after abcdefg --search d
efg
```
To use as a [standard stream][standard-streams],
```bash
$ echo -n $'bar\nbaz' | substring-after --search b
ar
az
```
By default, when used as a [standard stream][standard-streams], the implementation assumes newline-delimited data. To specify an alternative delimiter, set the `split` option.
```bash
$ echo -n 'bar\tbaz' | substring-after --search b --split '\t'
ar
az
```
[standard-streams]: https://en.wikipedia.org/wiki/Standard_streams
[mdn-regexp]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions
[@stdlib/string/substring-before]: https://github.com/stdlib-js/string/tree/main/substring-before
[@stdlib/string/substring-before-last]: https://github.com/stdlib-js/string/tree/main/substring-before-last
[@stdlib/string/substring-after-last]: https://github.com/stdlib-js/string/tree/main/substring-after-last