grapheme_substr

grapheme_substr(string $string, int $offset, [int $length], [string $locale]): string
```php

Devuelve una parte de un string.

## Parámetros

`string`  
El string a cortar. Debe ser UTF-8 y válido.

`offset`  
Posición de inicio en unidades de grafema por defecto. Si `offset` es estrictamente positivo, el string devuelto comenzará en la `offset` ésima posición en `string`, contando desde cero. Si `offset` es negativo, el string devuelto comenzará en la `offset` ésima unidad de grafema desde el final del string.

`length`  
El tamaño del sub-string a extraer, en unidades de grafema. Si `length` es dado y positivo, el string devuelto contendrá como máximo `length` grafemas, comenzando en `offset` (dependiendo del tamaño del string). Si `length` es proporcionado y es negativo, entonces se omitirán tantos grafemas desde el final del string (después de que la posición de inicio haya sido calculada, cuando `offset` también es negativo). Si `offset` denota una posición más allá del final del string, se devuelve un string vacío.

`locale`  
La configuración regional a utilizar.

## Valores devueltos

Devuelve la parte del string extraída de `string`, o `false` si ocurre un error.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.5.0 | Se ha añadido el parámetro opcional `locale`. |
| 8.0.0 | La función ahora corrige sistemáticamente los desplazamientos fuera de límites a los límites del string. Anteriormente, `false` era devuelto en lugar de un string vacío en algunos casos. |

## Ejemplos

Ejemplo con `grapheme_substr`

a%CC%8Abco%CC%88