in_array

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

in_arrayIndica si un valor pertenece a un array

Descripción

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

Busca needle en haystack utilizando una comparación flexible a menos que strict sea utilizado.

Parámetros

needle

El valor buscado.

Nota:

Si needle es un string, la comparación se realiza teniendo en cuenta la casilla.

haystack

El array.

strict

Si el tercer argumento strict está definido a true entonces la función in_array() verificará también que el tipo del argumento needle coincide con el tipo del valor encontrado en haystack.

Nota:

Antes de PHP 8.0.0, un string needle coincidirá con un valor de array de 0 en modo no estricto y viceversa. Esto puede llevar a resultados no deseados. Casos similares también existen para otros tipos. Si no se está absolutamente seguro de los tipos de valores involucrados, siempre se debe utilizar el flag strict para evitar cualquier comportamiento inesperado.

Valores devueltos

Devuelve true si needle es encontrado en el array, false en caso contrario.

Ejemplos

Ejemplo #1 Ejemplo con in_array()

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

La segunda condición falla, ya que in_array() es sensible a la casilla. El script devuelve:

Got Irix

Ejemplo #2 Ejemplo con in_array() y modo estricto

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

if (
in_array('12.4', $a, true)) {
echo
"'12.4' es encontrado con modo estricto\n";
}

if (
in_array(1.13, $a, true)) {
echo
"1.13 es encontrado con modo estricto\n";
}
?>

El resultado del ejemplo sería:

1.13 es encontrado con modo estricto

Ejemplo #3 Ejemplo con in_array() y un array como argumento

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

if (
in_array(array('p', 'h'), $a)) {
echo
"'ph' ha sido encontrado\n";
}

if (
in_array(array('f', 'i'), $a)) {
echo
"'fi' was found\n";
}

if (
in_array('o', $a)) {
echo
"'o' ha sido encontrado\n";
}
?>

El resultado del ejemplo sería:

'ph' ha sido encontrado
'o' ha sido encontrado

Ver también

  • array_search() - Busca en un array la primera clave asociada al valor
  • isset() - Determina si una variable está definida y no es null
  • array_key_exists() - Verifica si una clave existe en un array

add a note

User Contributed Notes 5 notes

up
422
beingmrkenny at gmail dot com
13 years ago
Loose checking returns some crazy, counter-intuitive results when used with certain arrays. It is completely correct behaviour, due to PHP's leniency on variable types, but in "real-life" is almost useless.

The solution is to use the strict checking option.

<?php

// Example array

$array = array(
'egg' => true,
'cheese' => false,
'hair' => 765,
'goblins' => null,
'ogres' => 'no ogres allowed in this array'
);

// Loose checking -- return values are in comments

// First three make sense, last four do not

in_array(null, $array); // true
in_array(false, $array); // true
in_array(765, $array); // true
in_array(763, $array); // true
in_array('egg', $array); // true
in_array('hhh', $array); // true
in_array(array(), $array); // true

// Strict checking

in_array(null, $array, true); // true
in_array(false, $array, true); // true
in_array(765, $array, true); // true
in_array(763, $array, true); // false
in_array('egg', $array, true); // false
in_array('hhh', $array, true); // false
in_array(array(), $array, true); // false

?>
up
5
Julian Sawicki
2 years ago
Here is a recursive in_array function:

<?php

$myNumbers
= [
[
1,2,3,4,5],
[
6,7,8,9,10],
];

$array = [
'numbers' => $myNumbers
];

// Let's try to find number 7 within $array
$hasNumber = in_array(7, $array, true); // bool(false)
$hasNumber = in_array_recursive(7, $array, true); // bool(true)

function in_array_recursive(mixed $needle, array $haystack, bool $strict): bool
{
foreach (
$haystack as $element) {
if (
$element === $needle) {
return
true;
}

$isFound = false;
if (
is_array($element)) {
$isFound = in_array_recursive($needle, $element, $strict);
}

if (
$isFound === true) {
return
true;
}
}

return
false;
}
up
11
rhill at xenu-directory dot net
16 years ago
I found out that in_array will *not* find an associative array within a haystack of associative arrays in strict mode if the keys were not generated in the *same order*:

<?php

$needle
= array(
'fruit'=>'banana', 'vegetable'=>'carrot'
);

$haystack = array(
array(
'vegetable'=>'carrot', 'fruit'=>'banana'),
array(
'fruit'=>'apple', 'vegetable'=>'celery')
);

echo
in_array($needle, $haystack, true) ? 'true' : 'false';
// Output is 'false'

echo in_array($needle, $haystack) ? 'true' : 'false';
// Output is 'true'

?>

I had wrongly assumed the order of the items in an associative array were irrelevant, regardless of whether 'strict' is TRUE or FALSE: The order is irrelevant *only* if not in strict mode.
up
2
leonhard dot radonic+phpnet at gmail dot com
2 years ago
I got an unexpected behavior working with in_array. I'm using following code:

<?php
// ...
$someId = getSomeId(); // it gets generated/fetched by another service, so I don't know what value it will have. P.S.: it's an integer

// The actual data in my edge-case scenario:
// $someId = 0;
// $anyArray = ['dataOne', 'dataTwo'];
if (in_array($someId, $anyArray)) {
// do some work
}
// ...
?>

With PHP7.4, in_array returns boolean true.
With PHP8.1, in_array returns boolean false.

It took me quite some time to find out what's going on.
up
0
eurorusty at yahoo dot ca
7 months ago
I'm not sure why PHP doesn't provide a way to specify a binary search. Here's an example of the performance gains, for this array size, about 50x improvement using interpreted PHP. If built in, it could probably achieve around 1000x improvement, again for this array size.

<?php

// Set up sorted array
$X = array(1);
for (
$j = 1; $j < 50000; ++$j)
$X[] = $X[$j - 1] + rand(1, 6);

// Using in_array
$x = -microtime(true);
$m = 0;
for (
$j = 0; $j < 10000; ++$j)
$m += in_array(rand(1, 175000), $X);
$x += microtime(true);
echo
$x.PHP_EOL;

// Using binarySearch
$x = -microtime(true);
$m = 0;
for (
$j = 0; $j < 10000; ++$j)
$m += binarySearch($X, rand(1, 175000));
$x += microtime(true);
echo
$x.PHP_EOL;

function
binarySearch($array, $value) {
$low = 0;
$high = count($array) - 1;
while (
$low <= $high) {
$pivot = floor(($low + $high) / 2);
if (
$array[$pivot] == $value)
return
true;
if (
$value < $array[$pivot])
$high = $pivot - 1;
else
$low = $pivot + 1;
}
// No match
return false;
}

/* Sample outputs, first is in_array, second is binarySearch
1.3544600009918
0.026464939117432

1.6158990859985
0.033976078033447

1.5184400081635
0.026461124420166
*/
To Top