PHP funkce strpos - výskyt podřetězce v řetězci

Funkce najde pozici prvního výskytu podřetězce v řetězci, což lidsky znamená, že ověří, jestli předaný řetězec obsahuje hledaný výraz a vrátí jeho pozici.

Funkce strpos vrací pozici hledaného textu v řetězci. Pokud řetězec obsahuje, vrátí pozici jeho prvního znaku jako integer (celé číslo), pokud neobsahuje, vrátí false (nepravda). Toho můžeme využít při testování řetězců.

Parametry

Výskyt řetězce v textu - aktualizace PHP 8

Od PHP 8 existuje nativní způsob, jak ověřit existence řetězce v textu. Dělá se to velmi jednoduše nativní funkcí str_contains:

if (str_contains('jan@barasek.com', '@')) {
    // E-mail obsahuje zavináč
}

Výskyt řetězce v textu

Pozor: Funkce str_contains je od PHP 8 nativní součást jazyka.

Často potřebujeme zjistit, jestli text obsahuje určitý řetězec. Až do verze PHP 8 neexistovala funkce str_contains, proto se předtím implementovala takto:

/**
 * Obsahuje $haystack řetězec $needle?
 */
function str_contains(string $haystack, string $needle): bool
{
    return strpos($haystack, $needle) !== false;
}

Podle toho lze sestavit například podmínka, zda řetězec obsahuje druhý řetězec a podle toho se dál zařídit:

if (strpos('jan@barasek.com', '@') !== false) {
    // E-mail obsahuje zavináč
}

Výhoda této metody ověření výskytu řetězce je její extrémní rychlost. Pokud potřebujete ověřit složitější shodu, budou potřeba regulární výrazy.

Návratové hodnoty

Funkce vždy vrátí pozici řetězce jako celé číslo (int), nebo hodnotu false (nepravda), pokud řetězec neobsahuje hledanou frázi.

Další zdroje

[Oficiální dokumentace funkce strpos](Oficiální manuál)

Jan Barášek   Více o autorovi

Autor článku pracuje jako seniorní vývojář a software architekt v Praze. Navrhuje a spravuje velké webové aplikace, které znáte a používáte. Od roku 2009 nabral bohaté zkušenosti, které tímto webem předává dál.

Rád vám pomůžu:

KontaktSpolupráce