array_search

]Podporované v PHP 4 >= 4.0.5, PHP 5

PHP -> Funkcie -> Array funkcie -> array_search

Syntax

mixed array_search ( mixed ihla, array stoh_sena [, bool skriktne] )

Popis

Príkaz jazyka PHP
Vyhľadáva v poli danú hodnotu a ak túto hodnotu našiel, vracia zodpovedajúci kľúč

Hľadá ihla v stoh_sena a vracia kľúč, ak sa v poli nájde, inak vracia FALSE.

Poznámka: Ak je ihla reťazec, porovnávanie sa vykoná v case-senzitívnom zmysle.
Poznámka: Pred PHP 4.2.0, array_search pri chybe vracala NULL namiesto FALSE.

Ak je tretí voliteľný paremeter striktne nastavený na TRUE potom array_search() tiež zistí typy ihla v stoh_sena.

Ak sa ihla nájde v stoh_sena viackrát, vráti sa prvý zhodujúci sa kľúč. Aby sa vrátili kľúče pre všetky zhodujúce sa hodnoty, radšej použite array_keys s voliteľným parametrom search_value.

Príklad

<?php
$pole = array(0 => 'modra', 1 => 'cervena', 2 => 'zelena', 3 => 'cervena');

$kluc = array_search('zelena', $pole); // $kluc = 2;
$kluc = array_search('cervena', $pole); // $kluc = 1;
?>

Varovanie

Táto funkcia môže vrátiť Boolean FALSE, ale môže tiež vrátiť ne-Booleanovskú hodnotu, ktorá sa vyhodnotí ako FALSE, ako je 0 alebo "". Prosím, prečítajte si sekciu o Booleanoch pre viac informácií. Používajte operátor === pre testovanie vrátenej hodnoty tejto funkcie.

Pozri aj

array_keys, array_values, array_key_exists, in_array

]