in_array

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

in_arrayComprueba 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.41.13);

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

if (
in_array(1.13$atrue)) {
    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