• « array_reverse
  • array_shift »
  • PHP Manual
  • Funcții ale tablourilor (Array)
  • Searches the array for a given value and returns the first corresponding key if successful

array_search

(PHP 4 >= 4.0.5, PHP 5, PHP 7)

array_search — Searches the array for a given value and returns the first corresponding key if successful

Descrierea

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

Searches for needle in haystack.

Parametri

needle

The searched value.

Notă:

If needle is a string, the comparison is done in a case-sensitive manner.

haystack

The array.

strict

If the third parameter strict is set to TRUE then the array_search() function will search for identical elements in the haystack. This means it will also perform a strict type comparison of the needle in the haystack, and objects must be the same instance.

Valorile întoarse

Returns the key for needle if it is found in the array, FALSE otherwise.

If needle is found in haystack more than once, the first matching key is returned. To return the keys for all matching values, use array_keys() with the optional search_value parameter instead.

Avertizare

Această funcție poate întoarce valoarea Boolean FALSE, dar poate de asemenea întoarce o valoare non-Boolean care evaluează în FALSE. Vă rugăm să citiți secțiunea despre tipul Boolean pentru informații suplimentare. Utilizați operatorul === pentru a verifica valoarea întoarsă de această funcție.

Istoricul schimbărilor

Versiune Descriere
5.3.0 As with all internal PHP functions as of 5.3.0, array_search() returns NULL if invalid parameters are passed to it.

Exemple

Example #1 array_search() example

<?php
$array 
= array(0 => 'blue', 1 => 'red', 2 => 'green', 3 => 'red');

$key = array_search('green', $array); // $key = 2;
$key = array_search('red', $array);   // $key = 1;
?>

A se vedea și

  • array_keys() - Return all the keys or a subset of the keys of an array
  • array_values() - Return all the values of an array
  • array_key_exists() - Checks if the given key or index exists in the array
  • in_array() - Checks if a value exists in an array