array_search

(PHP 4 >= 4.0.5, PHP 5)

array_search --  Vyhľadáva v poli danú hodnotu a ak túto hodnotu našiel, vracia zodpovedajúci kľúč

Popis

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

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 1. array_search() 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.

Tiež pozri array_keys(), array_values(), array_key_exists(), a in_array().