(PHP 5, PHP 7)
stripos — Findet das erste Vorkommen eines Teilstrings in einem String, unabhängig von Groß- und Kleinschreibung
Sucht die numerische Position des ersten Vorkommens von
needle
innerhalb des Strings
haystack
.
Im Gegensatz zu strpos() ist stripos() unabhängig von Groß- und Kleinschreibung.
haystack
Die Zeichenkette, in der gesucht werden soll.
needle
Beachten Sie, dass needle
eine Zeichenkette von
einem oder mehreren Zeichen sein kann.
Ist needle
kein String, wird der Parameter in einen
Integerwert konvertiert, der dem Ordinalwert des Zeichens entspricht.
offset
Wenn angegeben, dann beginnt die Suche diese Anzahl an Zeichen gezählt vom Beginn des Strings. Im Gegensatz zu strrpos() und strripos() kann der Offset nicht negativ sein.
Gibt die Position, an der sich die Needle befindet, relativ zum Beginn der
haystack
Zeichenkette zurück (unabhängig vom Offset).
Es ist zu beachten, dass Stringpositionen mit 0, und nicht mit 1 beginnen.
Gibt FALSE
zurück, wenn die Needle nicht gefunden wurde.
Diese Funktion kann sowohl das
boolsche FALSE
zurückliefern, als auch einen nicht-boolschen Wert, welcher zu FALSE
ausgewertet wird.
Weitere Informationen entnehmen Sie bitte dem Abschnitt über die
boolschen Typen. Benutzen Sie deshalb
den === Operator,
um den Rückgabewert dieser Funktion zu überprüfen.
Beispiel #1 stripos()-Beispiele
<?php
$findmich = 'a';
$meinstring1 = 'xyz';
$meinstring2 = 'ABC';
$pos1 = stripos($meinstring1, $findmich);
$pos2 = stripos($meinstring2, $findmich);
// 'a' ist natürlich nicht in 'xyz' enthalten
if ($pos1 === false) {
echo "Die Zeichenkette '$findmich' kommt nicht im String '$meinstring1' vor.";
}
// Beachten Sie die Verwendung von ===. Ein einfaches == funktioniert nicht wie
// erwartet, da 'a' an Position 0 (also erster!) Stelle steht
if ($pos2 !== false) {
echo "Die Zeichenkette '$findmich' wurde in '$meinstring2' an Position $pos2 gefunden";
}
?>
Hinweis: Diese Funktion ist binary safe.