Documentación offline PHP master

in_array

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

in_array

Indica si un valor pertenece a un array

Descripción#

in_array(mixed $needle, array $haystack, [bool $strict]): bool
```php

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

## Parámetros

`needle`  
El valor buscado.

> [!NOTE]
> 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](#language.types) del argumento `needle` coincide con el tipo del valor encontrado en `haystack`.

> [!NOTE]
> 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 con `in_array`
La segunda condición falla, ya que `in_array` es sensible a la casilla. El script devuelve:

    Got Irix

Ejemplo con `in_array` y modo estricto
El ejemplo anterior mostrará:

    1.13 es encontrado con modo estricto

Ejemplo con `in_array` y un array como argumento

```php

El ejemplo anterior mostrará:

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

Véase también#

array_search, isset, array_key_exists