strpos

(PHP 3, PHP 4 )

strpos -- Najít pozici prvního výskytu řetězce

Popis

int strpos ( string haystack, string needle [, int offset])

Vrací číselnou pozici prvního výskytu needle v řetězci haystack. Narozdíl od strrpos() tato funkce přijme jako argument needle řetězec více znaků, a celý tento řetězec se použije.

Pokud needle nenajde, vrací FALSE.

Poznámka: Návratové hodnoty "znak nalezen na pozici 0" a "znak nenalezen" se dají snadno zaměnit. Tady je návod, jak zjistit tento rozdíl:

// v PHP 4.0b3 a novějších:
$pos = strpos ($mystring, "b");
if ($pos === false) { // tři rovnítka
    // nenalezeno...
}

// ve verzích starších než 4.0b3:
$pos = strpos ($mystring, "b");
if (is_string ($pos) && !$pos) {
    // nenalezeno...
}

Pokud needle není řetězec, převede se na integer a použije se jako XXX ordinal hodnota znaku.

Volitelný argument offset vám umožňuje určit na které pozici v haystack má hledání začít. Vrácená pozice je i tak relativní k začátku haystack.

Viz také: strrpos(), strrchr(), substr(), stristr() a strstr().