Funkcja array_search() w PHP

Funkcje tablic PHP

Przykład

Wyszukiwanie klucza wartości "red" w tablicy i zwracanie jego nazwy klucza:

<?php
$a=array("a"=>"red","b"=>"green","c"=>"blue");
echo array_search("red",$a);
?>

Uruchomienie przykładu

Definicja i użycie

Funkcja array_search() wyszukuje pewną wartość w tablicy i zwraca odpowiednią nazwę klucza.

Szczegółowe wyjaśnienie

Funkcja array_search() w porównaniu do in_array() Tak, w wyszukiwaniu klucza wartości w tablicy. Jeśli znajdziesz wartość, nazwa klucza elementu pasującego zostanie zwrócona. Jeśli nie znajdziesz, zwróci fałsz.

Przed PHP 4.2.0, funkcja zwraca null zamiast false w przypadku niepowodzenia.

jeśli trzeci parametr strict ustawiona na true, zwraca nazwę klucza elementu tylko wtedy, gdy dane mają identyczny typ i wartość.

syntaktyka

array_search(value,array,strict)
parametry opis
value wymagane. Określa wartość klucza do przeszukiwania.
array wymagane. Określa tablicę do przeszukiwania.
strict

opcjonalnie. Jeśli ten parametr ustawiono na TRUE, funkcja szuka w tablicy elementów, które mają identyczny typ danych i wartość.

  • true
  • false - domyślnie

Jeśli ustawiono wartość na true, w tablicy sprawdzany jest typ danej oraz wartość, liczba 5 i ciąg znaków 5 są różne (zobacz przykład 2).

Szczegóły techniczne

Wartość zwracana:

Jeśli w tablicy znajduje się określona wartość klucza, zwraca odpowiednią nazwę klucza, w przeciwnym razie zwraca FALSE.

Jeśli w tablicy znajduje się klucz o wartości więcej niż raz, zwraca nazwę klucza dla pierwszego znalezionego klucza o wartości.
Wersja PHP: 4.0.5+
Dziennik aktualizacji:

Jeśli przekazano do funkcji niewłaściwe parametry, funkcja zwraca NULL (to dotyczy wszystkich funkcji PHP od PHP 5.3.0).

Od PHP 4.2.0, jeśli wyszukiwanie się nie powiedzie, funkcja zwraca FALSE zamiast NULL.

Więcej przykładów

Przykład 1

Szukaj klucza o wartości 5 w tablicy i zwróć jego nazwę (uwaga "":)

<?php
$a=array("a"=>"5","b"=>5,"c"=>"5");
echo array_search(5,$a,true);
?>

Uruchomienie przykładu

Funkcje tablic PHP