| CARVIEW |
mb_strpos
(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)
mb_strpos — Localiza la primera ocurrencia de un carácter en una cadena
Descripción
Localiza la posición de la primera ocurrencia de needle en el string haystack.
Realiza una búsqueda de tipo
strpos(), teniendo en cuenta los caracteres
multioctetos. La posición de needle se cuenta
desde el inicio de la cadena haystack: las
posiciones comienzan en 0.
Parámetros
haystack-
El string a partir del cual se obtiene la posición de la primera aparición de
needle. needle-
La string a encontrar en el parámetro
haystack. A diferencia de la función strpos(), los valores numéricos no se aplican como valor ordinal de un carácter. offset-
La posición de inicio de la búsqueda. Si se omite, se utilizará cero. Una posición negativa se cuenta desde el final de la string.
encoding-
The
encodingparameter is the character encoding. If it is omitted ornull, the internal character encoding value will be used.
Valores devueltos
Devuelve la posición numérica de
la primera ocurrencia del carácter needle en la
cadena haystack. Si needle no se
encuentra, mb_strpos() devuelve false.
Errores/Excepciones
-
Si
offsetes mayor que la longitud dehaystack, se lanzará un ValueError.
Historial de cambios
| Versión | Descripción |
|---|---|
| 8.0.0 |
needle now accepts an empty string.
|
| 8.0.0 |
encoding is nullable now.
|
| 7.1.0 |
Se añadió soporte para offsets negativos.
|
Ver también
- mb_internal_encoding() - Lee/modifica la codificación interna
- strpos() - Busca la posición de la primera ocurrencia en un string