Documentación offline PHP master

grapheme_strpos

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

grapheme_strpos

Encuentra la posición del primer grafema

Descripción#

Estilo procedimental

grapheme_strpos(string $haystack, string $needle, [int $offset], [string $locale]): int
```php

Encuentra la posición del primer grafema en una cadena.

## Parámetros

`haystack`  
La cadena a estudiar. Debe estar en formato UTF-8 válido.

`needle`  
La cadena a estudiar. Debe estar en formato UTF-8 válido.

`offset`  
El parámetro `offset` permite especificar la posición en la `haystack` donde comienza la búsqueda, expresada en grafemas (y no en bytes o caracteres). Si el offset es negativo, se trata con respecto al final de la cadena de caracteres. La posición devuelta siempre se da con respecto al inicio de `haystack`, independientemente del valor de `offset`.

`locale`  
La configuración regional a utilizar.

## Valores devueltos

Devuelve la posición en forma de entero. Si `needle` no es encontrado, `grapheme_strpos` devuelve `false`.

## Historial de cambios

| Versión | Descripción                                   |
|---------|-----------------------------------------------|
| 8.5.0   | Se ha añadido el parámetro opcional `locale`. |
| 7.1.0   | Se añade el soporte para `offset`s negativos. |

## Ejemplos

Ejemplo con `grapheme_strpos`

```php

El ejemplo anterior mostrará:

2

Véase también#

grapheme_stripos, grapheme_stristr, grapheme_strripos, grapheme_strrpos, grapheme_strstr, Unicode Text Segmentation: Grapheme Cluster Boundaries