Descripción
int
strpos ( string cadena, string caracter [, int desplazamiento] )
Devuelve la posición numérica de la primera aparición de la
caracter en la cadena
cadena. A diferencia de
strrpos(), esta función puede tomar una
cadena completa como caracter y se utilizará
en su totalidad.
Si no se encuentra el caracter, devuelve FALSE.
| Aviso |
Esta función
puede devolver FALSE, pero también puede devolver un valor
no-booleano que será evaluado FALSE, como por ejemplo
0 o "". Por favor, lea la sección
Booleans para más
información. Utilice el operador === para
comprobar el valor devuelto por esta
función. |
Nota: Esta función es segura
binariamente.
Ejemplo 1. Ejemplos de strpos()
<?php $mi_cadena = 'abc'; $caracter = 'a'; $posicion = strpos($mi_cadena, $caracter);
// Seguidamente se utiliza ===. La forma simple de comparacion (==) // no funciona como deberia, ya que la posicion de 'a' es el caracter // numero 0 (cero) if ($posicion === false) { echo "No se encontro '$caracter' en la cadena '$mi_cadena'"; } else { echo "Se encontro '$caracter' en la cadena '$mi_cadena'"; echo " en la posicion $posicion"; }
// Se puede buscar el caracter sin tener en cuenta los caracteres anteriores // al desplazamiento $nueva_cadena = 'abcdef abcdef'; $posicion = strpos($nueva_cadena, 'a', 1); // $posicion = 7, no 0 ?>
|
|
Si el caracter no es una cadena, se convierte
a entero y se aplica como el valor ordinal de un carácter.
El parámetro opcional desplazamiento le permite
especificar a partir de qué carácter de la cadena
se empieza a buscar. La posición devuelta sigue siendo relativa al comienzo
de cadena.
Vea también strrpos(),
stripos(),
strripos(),
strrchr(),
substr(),
stristr() y
strstr().