strpos

(PHP 3, PHP 4 )

strpos --  Ermitteln des ersten Vorkommens innerhalb eines Strings

Beschreibung:

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

Gibt als numerischen Wert die Position des ersten Vorkommens von needle innerhalb der Zeichenkette haystack zurück. Anders als bei strrpos() kann diese Funktion eine komplette Zeichenkette unterstützen.

Wurde needle nicht gefunden, wird FALSE zurück gegeben.

Anmerkung: Die Meldungen "Zeichen bei Position 0 gefunden (character found at position 0)" und "Zeichen nicht gefunden (character not found)" werden oft falsch ausgelegt. Hier die Unterscheidung:

// in PHP 4.0b3 und danach:
$pos = strpos ($mystring, "b");
if ($pos === false) { // Achtung: 3 Gleichheits-Zeichen
    // nicht gefunden...
}

// in Versionen vor 4.0b3:
$pos = strpos ($mystring, "b");
if (is_string ($pos) && !$pos) {
    // nicht gefunden...
}

Ist needle kein String, wird er zu einem Integer-Wert umgesetzt und als das diesem Wert entsprechende ASCII-Zeichen angesehen.

Der optionale Parameter offset ermöglicht es, den Startwert für die Suche nach needle innerhalb von haystack anzugeben. Die zurück gegebene Positions-Angabe ist dann relativ zum Anfang von haystack.

Siehe auch strrpos(), strrchr(), substr(), stristr() und strstr().