Documentación offline PHP master

grapheme_stripos

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

En esta página

grapheme_stripos

Encuentra la posición en grafema de la primera ocurrencia en una cadena, insensible a mayúsculas/minúsculas

Descripción#

Estilo procedimental

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

Encuentra la posición en grafema de la primera ocurrencia en una cadena, realizando una búsqueda insensible a mayúsculas/minúsculas.

## Parámetros

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

`needle`  
La cadena a buscar. 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_stripos` 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ñadió el soporte para `offset`s negativos. |

## Ejemplos

Ejemplo con `grapheme_stripos`

```php

El ejemplo anterior mostrará:

2

Véase también#

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