strripos
(PHP 5, PHP 7, PHP 8)
strripos — Findet das letzte Vorkommen der gesuchten Zeichenkette in einem String, unabhängig von Groß- und Kleinschreibung
Beschreibung
$haystack, string $needle, int $offset = 0): int|false
Findet das letzte Vorkommen von needle im String
haystack.
Im Gegensatz zu strrpos() beachtet strripos() die Groß- und Kleinschreibung nicht.
Parameter-Liste
-
haystack -
Die Zeichenkette, in der gesucht werden soll.
-
needle -
Wenn der Parameter
needlekeine Zeichenkette ist, wird er vor PHP 8.0.0 in eine Ganzzahl umgewandelt und als ordinaler Wert eines Zeichens betrachtet. Dieses Verhalten gilt seit PHP 7.3.0 als veraltet und es wird dringend empfohlen, sich nicht darauf zu verlassen. Ist das Verhalten gewünscht, so sollteneedleexplizit in eine Zeichenkette umgewandelt werden oder explizit die Funktion chr() aufgerufen werden. -
offset -
Wenn null (
0) oder positiv, wird die Suche von links nach rechts durchgeführt, wobei die erstenoffsetBytes deshaystackübersprungen werden.Wenn negativ, wird die Suche von rechts nach links durchgeführt, wobei die letzten
offsetBytes deshaystackübersprungen werden.Hinweis:
Dies bedeutet, dass das letzte Vorkommen von
needlevor den letztenoffsetBytes gesucht wird.
Rückgabewerte
Gibt die Position zurück, an der needle relativ zum
Anfang der Zeichenkette haystack vorkommt
(unabhängig von Suchrichtung oder Offset).
Hinweis: Positionen in Zeichenketten werden ab 0 gezählt, und nicht ab 1.
Wenn needle nicht gefunden wird, gibt die Funktion
false zurück.
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.
Changelog
| Version | Beschreibung |
|---|---|
| 8.0.0 |
Die Übergabe eines Integer als needle wird
nicht mehr unterstützt.
|
| 7.3.0 |
Die Übergabe eines Integer als needle wird
missbilligt.
|
Beispiele
Beispiel #1 Ein einfaches strripos()-Beispiel
<?php
$haystack = 'ababcd';
$needle = 'aB';
$pos = strripos($haystack, $needle);
if ($pos === false) {
echo "Leider wurde ($needle) nicht in ($haystack) gefunden.";
} else {
echo "Glückwunsch!\n";
echo "Das letzte Vorkommen von ($needle) in ($haystack) ist an Position ($pos).";
}
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Glückwunsch! Das letzte Vorkommen von (aB) in (ababcd) ist an Position (2).
Siehe auch
- strpos() - Sucht die Position des ersten Vorkommens des Suchstrings in einem String
- stripos() - Findet das erste Vorkommen eines Teilstrings in einem String, unabhängig von Groß- und Kleinschreibung
- strrpos() - Findet die Position des letzten Vorkommens eines Teilstrings innerhalb einer Zeichenkette
- strrchr() - Sucht das letzte Vorkommen eines Zeichens in einem String
- stristr() - Wie strstr, aber unabhängig von Groß- bzw. Kleinschreibung
- substr() - Liefert einen Teil eines Strings
