# sliceGraphemeClusters
> Slice a string based on grapheme cluster (i.e., user-perceived character) indices.
## Usage
```javascript
var sliceGraphemeClusters = require( '@stdlib/string/base/slice-grapheme-clusters' );
```
#### sliceGraphemeClusters( str, start, end )
Slices a string based on grapheme cluster (i.e., user-perceived character) indices.
```javascript
var out = sliceGraphemeClusters( 'Hello World', 0, 5 );
// returns 'Hello'
out = sliceGraphemeClusters( 'πππ', 0, 2 );
// returns 'ππ'
out = sliceGraphemeClusters( 'ε
δΉ¦/ε
ζΈ', 1, 5 );
// returns 'δΉ¦/ε
ζΈ'
out = sliceGraphemeClusters( 'π·πππΏ', 1, 2 );
// returns 'π'
```
The function accepts the following arguments:
- **str**: input string.
- **start**: the `ith` grapheme cluster to start a slice (inclusive).
- **end**: the `jth` grapheme cluster to end a slice (exclusive).
## Examples
```javascript
var sliceGraphemeClusters = require( '@stdlib/string/base/slice-grapheme-clusters' );
console.log( sliceGraphemeClusters( 'Hello World', 0, 5 ) );
// => 'Hello'
console.log( sliceGraphemeClusters( 'Hello World', -5, -1 ) );
// => 'Worl'
console.log( sliceGraphemeClusters( 'πππ', 0, 2 ) );
// => 'ππ'
console.log( sliceGraphemeClusters( 'ε
δΉ¦/ε
ζΈ', 1, 5 ) );
// => 'δΉ¦/ε
ζΈ'
console.log( sliceGraphemeClusters( 'π¨βπ©βπ§βπ¦π¨βπ©βπ§βπ¦π¨βπ©βπ§βπ¦', 0, 2 ) );
// => 'π¨βπ©βπ§βπ¦π¨βπ©βπ§βπ¦'
```