Gibt den String haystack ab dem ersten Vorkommen (inklusive)
von needle bis zum Ende zurück.
haystackDie Zeichenkette, in der gesucht werden soll.
needle
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.
before_needle
Wenn der Wert auf TRUE gesetzt ist, gibt
stristr() den Teil von haystack
vor dem ersten Auftreten von needle zurück (ohne
needle selbst).
needle und haystack
werden ohne Rücksicht auf Groß- oder Kleinschreibung untersucht.
Gibt den gefundenen Teilstring zurück. Wenn needle
nicht gefunden wurde, gibt die Funktion FALSE zurück.
| Version | Beschreibung |
|---|---|
| 7.3.0 |
Die Übergabe eines int als needle wurde missbilligt.
|
Beispiel #1 stristr()-Beispiel
<?php
$email = 'USER@EXAMPLE.com';
echo stristr($email, 'e'); // Ausgabe: ER@EXAMPLE.com
echo stristr($email, 'e', true); // Ab PHP 5.3.0, Ausgabe: US
?>
Beispiel #2 Prüfen, ob ein String gefunden wurde oder nicht
<?php
$string = 'Hallo Welt!';
if(stristr($string, 'Erde') === FALSE) {
echo '"Erde" nicht gefunden';
}
// Ausgabe: "Erde" nicht gefunden
?>
Beispiel #3 Verwendung eines Wertes, der kein String ist
<?php
$string = 'APFEL';
echo stristr($string, 97); // 97 = kleines a
// Ausgabe: APFEL
?>
Hinweis: Diese Funktion ist binary safe.