(PHP 4, PHP 5, PHP 7, PHP 8)
strstr — Findet das erste Vorkommen eines Strings
Gibt den Teil der Zeichenkette haystack
ab dem
ersten Vorkommen (inklusive) von needle
bis zum Ende
von haystack
zurück.
Hinweis:
Diese Funktion unterscheidet zwischen Groß- und Kleinschreibung. Soll die Suche nicht zwischen Groß- und Kleinschreibung unterscheiden, verwenden Sie stristr().
Hinweis:
Wenn nur es nur darum geht, festzustellen, ob ein bestimmter
needle
innerhalb vonhaystack
vorkommt, sollte stattdessen die schnellere und weniger speicherintensive Funktion strpos() verwendet werden.
haystack
Die Eingabezeichenkette.
needle
Die Zeichenkette, nach der gesucht werden soll.
Wenn der Parameter needle
keine 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 sollte needle
explizit in
eine Zeichenkette umgewandelt werden oder explizit die Funktion
chr() aufgerufen werden.
before_needle
Ist der Wert auf true
gesetzt, gibt strstr()
den Teil von haystack
zurück, der sich vor
dem ersten Vorkommen von needle
befindet (ohne
needle selbst).
Gibt einen Teil der Zeichenkette zurück. Wird needle
nicht gefunden, wird false
zurückgegeben.
Version | Beschreibung |
---|---|
8.0.0 |
needle akzeptiert nun eine leere Zeichenkette.
|
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.
|
Beispiel #1 strstr()-Beispiel
<?php
$email = 'name@example.com';
$domain = strstr($email, '@');
echo $domain; // Ausgabe: @example.com
$user = strstr($email, '@', true);
echo $user; // Ausgabe: name
?>