strstr
(PHP 4, PHP 5, PHP 7, PHP 8)
strstr — Findet das erste Vorkommen eines Strings
Beschreibung
$haystack, string $needle, bool $before_needle = false): string|false
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 Sie nur herausfinden möchten, ob ein bestimmter
needleinnerhalb vonhaystackvorkommt, verwenden Sie stattdessen die schnellere und weniger speicherintensive Funktion strpos().
Parameter-Liste
-
haystack -
Die Eingabezeichenkette.
-
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. -
before_needle -
Ist der Wert auf
truegesetzt, gibt strstr() den Teil vonhaystackzurück, der sich vor dem ersten Vorkommen vonneedlebefindet (ohne needle selbst).
Rückgabewerte
Gibt einen Teil der Zeichenkette zurück. Wird needle
nicht gefunden, wird false zurückgegeben.
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 strstr()-Beispiel
<?php
$email = 'name@example.com';
$domain = strstr($email, '@');
echo $domain; // Ausgabe: @example.com
$user = strstr($email, '@', true);
echo $user; // Ausgabe: name
?>
Siehe auch
- stristr() - Wie strstr, aber unabhängig von Groß- bzw. Kleinschreibung
- strrchr() - Sucht das letzte Vorkommen eines Zeichens in einem String
- strpos() - Sucht die Position des ersten Vorkommens des Suchstrings in einem String
- strpbrk() - Durchsucht einen String nach einem Zeichen aus einer Gruppe von Zeichen
- preg_match() - Führt eine Suche mit einem regulären Ausdruck durch
