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

Hosting by: hurra.com
Generated: 2007-01-26 18:01:07