strpos

(PHP 3, PHP 4 )

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

Descripción

int strpos ( string pajar, string aguja [, int desplazamiento])

Devuelve la posición numérica de la primera aparición de la aguja en la cadena pajar. A diferencia de strrpos(), esta función puede tomar una cadena completa como aguja y se utilizará en su totalidad.

Si la aguja no es hayada, devuelve FALSE.

Nota: Es fácil confundir los valores de retorno para "caracter encontrado en la posición 0" y "caracter no encontrado". Aquí se indica cómo detectar la diferencia:

// en PHP 4.0b3 y posteriores:
$pos = strpos ($micadena, "b");
if ($pos === false) { // nota: tres signos igual
    // no encontrado ...
}

// en versiones anteriores a la 4.0b3:
$pos = strpos ($micadena, "b");
if (is_string ($pos) && !$pos) {
    // no encontrado ...
}

Si la aguja no es una cadena, se convierte a entero y se aplica como el valor ordinal de un caracter.

El parámetro opcional desplazamiento le permite especificar a partir de qué caracter del pajar comenzar a buscar. La posición devuelta es aún relativa al comienzo de pajar.

Vea también strrpos(), strrchr(), substr(), stristr(), y strstr().