in_array

(PHP 4, PHP 5, PHP 7, PHP 8)

in_array — Comprueba si un valor existe en un array

Descripción

in_array(mixed$needle, array$haystack, bool$strict = false): bool

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 primera 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