time-to-botec/js/node_modules/@stdlib/string/num-grapheme-clusters

numGraphemeClusters

Return the number of grapheme clusters in a string.

Usage

var numGraphemeClusters = require( '@stdlib/string/num-grapheme-clusters' );

numGraphemeClusters( str )

Returns the number of grapheme clusters in a string.

var out = numGraphemeClusters( 'last man standing' );
// returns 17

out = numGraphemeClusters( 'Hidden Treasures' );
// returns 16

Examples

var numGraphemeClusters = require( '@stdlib/string/num-grapheme-clusters' );

var str = numGraphemeClusters( 'last man standing' );
// returns 17

str = numGraphemeClusters( '六书/六書' );
// returns 5

str = numGraphemeClusters( 'अनुच्छेद' );
// returns 5

str = numGraphemeClusters( '🌷' );
// returns 1

---

CLI

Usage

Usage: num-grapheme-clusters [options] [<string>]

Options:

  -h,    --help                Print this message.
  -V,    --version             Print the package version.
  -l,    --lines               Analyze individual lines.

Examples

$ num-grapheme-clusters beep
4

To use as a standard stream,

$ echo -n 'beep\nboop🌷' | num-grapheme-clusters
10

$ echo -n 'beep\nboop🌷' | num-grapheme-clusters -l
4
5

---

See Also

• @stdlib/string/next-grapheme-cluster-break: return the next extended grapheme cluster break in a string after a specified position.