in_array

(PHP 4, PHP 5)

in_array — Comprueba si un valor existe en un array

Descripción

bool in_array ( mixed $needle , array $haystack [, bool $strict = FALSE ] )

Busca la aguja (needle) en el pajar (haystack) usando una comparación flexible a menos que esté establecido strict.

Parámetros

needle: El valor a buscar.

Nota:
Si needle es un string, la comparación se realiza considerando las mayúsculas/minúsculas.
haystack: El array.
strict: Si el tercer parámetro strict está establecido a TRUE, la función in_array() también comprobará los tipos de needle en haystack.

Valores devueltos

Devuelve TRUE si needle se encuentra en el array, FALSE de lo contrario.

Ejemplos

Ejemplo #1 Ejemplo de in_array()


<?php
$os = array("Mac", "NT", "Irix", "Linux");
if (in_array("Irix", $os)) {
    echo "Existe Irix";
}
if (in_array("mac", $os)) {
    echo "Existe mac";
}
?>

La segunda condición falla porque in_array() considera las mayúsculas-minúsculas, así que el programa anterior mostrará:

Existe Irix

Ejemplo #2 Ejemplo de in_array() en modo estricto


<?php
$a = array('1.10', 12.4, 1.13);

if (in_array('12.4', $a, true)) {
    echo "Se encontró '12.4' con comprobación estricta\n";
}

if (in_array(1.13, $a, true)) {
    echo "Se encontró 1.13 con comprobación estricta\n";
}
?>

El resultado del ejemplo sería:

Se encontró 1.13 con comprobación estricta

Ejemplo #3 in_array() con un array como aguja


<?php
$a = array(array('p', 'h'), array('p', 'r'), 'o');

if (in_array(array('p', 'h'), $a)) {
    echo "Se encontró 'ph'\n";
}

if (in_array(array('f', 'i'), $a)) {
    echo "Se encontró 'fi'\n";
}

if (in_array('o', $a)) {
    echo "Se encontró 'o'\n";
}
?>

El resultado del ejemplo sería:

  Se encontró 'ph'
  Se encontró 'o'

Ver también

array_search() - Busca un valor determinado en un array y devuelve la clave correspondiente en caso de éxito
isset() - Determina si una variable está definida y no es NULL
array_key_exists() - Verifica si el índice o clave dada existe en el array