PHP - array_search
Třída
Metoda - array_search
(PHP 4 >= 4.0.5, PHP 5, PHP 7)
Vyhledá v poli daný prvek. O problému hovoříme jako o hledání jehly v kupce sena.
Procedurální
- function array_search (mixed $needle, array $haystack, bool $strict = false) : mixed
Parametry
Název | Datový typ | Výchozí hodnota | Popis |
---|---|---|---|
$needle | mixed | Jehla (řetězec k nalezení). | |
$haystack | array | Kupka sena (kde hledat). | |
$strict | bool | false | Třetí, nepovinný parametr je typu |
Návratové hodnoty
Vrací: mixed
Klíč, pod kterým se jehla nalézá. V případě nenalezení vrátí
FALSE. Jelikož jehla může být nalezena na pozici 0, musíme
výsledek porovnávat pomocí ===
. Při neplatných parametrech
vrátí NULL.
Příklady
<?php
$pole =['Homer', 'Marge', 'Bart', 'Lisa', 'Meggie'];
$klic = array_search('Bart', $pole);
echo $klic;
Související manuály
- function array_keys (array $array, mixed $search_value = null, bool $strict = false) : array
- function array_key_exists (mixed $key, array $array) : bool
- function array_values (array $array) : array
- function in_array (mixed $needle, array $haystack, bool $strict = false) : bool