(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.
haystackDie Zeichenkette, in der gesucht werden soll.
needle
Beachten Sie, dass needle eine Zeichenkette von
einem oder mehreren Zeichen sein kann.
Ist der Parameter needle kein String,
so wird dieser in eine Ganzzahl umgewandelt und als ordinaler Wert
eines Zeichens betrachtet. Dieses Verhalten gilt seit PHP 7.3.0 als
veraltete und es wird stark empfohlen, sich nicht darauf zu verlassen.
Ist das Verhalten gewünscht, so sollte man explizit zu einer
Zeichenkette casten oder explizit die Funktion chr()
aufrufen.
offsetWenn angegeben, dann beginnt die Suche diese Anzahl an Zeichen gezählt vom Beginn des Strings. Ist der Offset negativ, beginnt die Suche diese Anzahl von Zeichen gezählt vom Ende der Zeichenkette.
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.
| Version | Beschreibung |
|---|---|
| 7.1.0 |
Unterstützung für negative offset-Werte wurde hinzugefügt.
|
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.