# strstr

(PHP 4, PHP 5, PHP 7, PHP 8)

strstr — Findet das erste Vorkommen eines Strings

### Beschreibung

strstr(string `$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 nur es nur darum geht, festzustellen, ob ein bestimmter `needle` innerhalb von `haystack` vorkommt, sollte stattdessen die schnellere und weniger speicherintensive Funktion strpos() verwendet werden.

### Parameter-Liste

`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).

### Rückgabewerte

Gibt einen Teil der Zeichenkette zurück. Wird `needle` nicht gefunden, wird `false` zurückgegeben.

### Changelog

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.

### Beispiele

Beispiel #1 strstr()-Beispiel

`<?php
$email = 'name@example.com';
$domain = strstr($email, '@');
echo $domain, PHP_EOL; // Ausgabe: @example.com
$user = strstr($email, '@', true);
echo $user, PHP_EOL; // 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open