PHP - in_array

Třída

Kořen \ Bez třídy

Metoda - in_array

(PHP 4, PHP 5, PHP 7)

Funkce zjišťuje, jestli se zadaná hodnota vyskytuje v daném poli.

Procedurální

• function in_array (mixed $needle, array $haystack, bool $strict = false) : bool

Parametry

Název	Datový typ	Výchozí hodnota	Popis
$needle	mixed		Hodnota, jejíž výskyt hledáme v zadaném poli. Pokud hledáme textový řetězec, tak při porovnávaní záleží na velikosti znaků (je case-sensitive).
$haystack	array		Pole, v kterém hledáme výskyt dané hodnoty.
$strict	bool	false	Když je parametr zadán jako true, funkce porovnává také typ hledané hodnoty. (7 není totéž co "7").

Návratové hodnoty

Vrací: bool

Když se hodnota nachází v daném poli, funkce vrací true, jinak vrací false.

Příklady

Když hledáme textový řetězec, záleží na velikosti znaků (case-sensitive).

<?php
$slecny = array("Janka","Diana","Mirka","Tereza","Lydia");
echo in_array("Diana",$slecny) ? "Diana se nachází v poli $slecny. <br>" : "Diana se nenachází poli $slecny. <br>";
echo in_array("diana",$slecny) ? "diana se nachází v poli $slecny. <br>" : "diana se nenachází poli $slecny. <br>";

Když zadáme třetí parametr jako true, funkce porovnává taky typ hledané hodnoty.

<?php
$roky = array(1970, 1971, 1972, 1975, 1978);
echo in_array(1975,$roky) ? "Číslo 1975 se nachází v poli $roky. <br>" : "Číslo 1975 se nenachází v poli roky. <br>";
echo in_array("1975",$roky) ? "Číslo 1975 zadané jako text se nachází v poli $roky. <br>" : "Číslo 1975 zadané jako text se nenachází v poli $roky. <br>";
echo in_array("1975",$roky, true) ? "Číslo 1975 zadané jako text se nachází v poli $roky. <br>" : "Číslo 1975 zadané jako text se nenachází v poli $roky. <br>";

Hledaná hodnota může být taky pole.

<?php
$auta = array( array("Mercedes","Audi","BMW"), array("Toyota", "Mazda"));
echo in_array(array("Mercedes", "Audi"), $auta) ? "Pole se s hodnotami Mercedes a Audi se nachází v poli $auta. <br>" : "Pole se s hodnotami Mercedes a Audi se nenachází v poli $auta. <br>";
echo in_array(array("Toyota", "Mazda"), $auta) ? "Pole se s hodnotami Toyota a Mazda se nachází v poli $auta. <br>" : "Pole se s hodnotami Toyota a Mazda se nenachází v poli $auta. <br>";
echo in_array(array("Mazda", "Toyota"), $auta) ? "Pole se s hodnotami Mazda a Toyota se nachází v poli $auta. <br>" : "Pole se s hodnotami Mazda a Toyota se nenachází v poli $auta. <br>";