strpos
Manual de PHP
AnteriorSiguiente

strpos

(PHP 3, PHP 4, PHP 5)

strpos --  Encuentra la posici贸n de la primera aparici贸n de una cadena

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().

AnteriorInicioSiguiente
strpbrkSubirstrrchr