# nextGraphemeClusterBreak
> Return the next extended grapheme cluster break in a string after a specified position.
## Usage
```javascript
var nextGraphemeClusterBreak = require( '@stdlib/string/next-grapheme-cluster-break' );
```
#### nextGraphemeClusterBreak( string\[, fromIndex] )
Returns the next extended grapheme cluster break in a string after a specified position.
```javascript
var out = nextGraphemeClusterBreak( 'last man standing' );
// returns 1
```
By default, the function searches for a grapheme cluster break starting from the first index. To specify an alternative starting search index, provide a `fromIndex` argument.
```javascript
var out = nextGraphemeClusterBreak( 'last man standing', 4 );
// returns 5
```
## Notes
- If `string` is an empty string, the function returns `-1` irrespective of `fromIndex`.
- If an extended grapheme cluster break does not exist after `fromIndex`, the function returns `-1`.
- Note that `fromIndex` does **not** refer to a visual character position, but to an index in the ordered sequence of [UTF-16][utf-16] code units.
## Examples
```javascript
var nextGraphemeClusterBreak = require( '@stdlib/string/next-grapheme-cluster-break' );
var out = nextGraphemeClusterBreak( 'last man standing', 4 );
// returns 5
out = nextGraphemeClusterBreak( 'presidential election', 8 );
// returns 9
out = nextGraphemeClusterBreak( 'अनुच्छेद', 1 );
// returns 3
out = nextGraphemeClusterBreak( '🌷', 0 );
// returns -1
```
* * *
## CLI
### Usage
```text
Usage: next-grapheme-cluster-break [options] []
Options:
-h, --help Print this message.
-V, --version Print the package version.
--from index Starting search position in string. Default: 0.
```
### Examples
```bash
$ next-grapheme-cluster-break --from=1 अनुच्छेद
3
```
To use as a [standard stream][standard-streams],
```bash
$ echo -n 'अनुच्छेद' | next-grapheme-cluster-break --from=1
3
```
[standard-streams]: https://en.wikipedia.org/wiki/Standard_streams
[utf-16]: https://en.wikipedia.org/wiki/UTF-16
[@stdlib/string/num-grapheme-clusters]: https://github.com/stdlib-js/string/tree/main/num-grapheme-clusters