strstr

(PHP 4, PHP 5)

strstr — Findet das erste Vorkommen eines Strings

Beschreibung

string strstr ( string $haystack , mixed $needle [, bool $before_needle = 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 needle innerhalb von haystack vorkommt, verwenden Sie stattdessen die schnellere und weniger speicherintensive Funktion strpos().

Parameter-Liste

haystack

Die Eingabezeichenkette.

needle

Ist needle kein String, wird der Parameter in einen Integerwert konvertiert, der dem Ordinalwert des Zeichens entspricht.

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
5.3.0 Der optionale Parameter before_needle wurde hinzugefügt.
4.3.0 strstr() ist nun binary safe.

Beispiele

Beispiel #1 strstr()-Beispiel

<?php
$email  = 'name@example.com';
$domain = strstr($email, '@');
echo $domain; // Ausgabe: @example.com

$user = strstr($email, '@', true); // Ab PHP 5.3.0
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 das erste Vorkommen des Suchstrings
  • strpbrk() - Durchsucht einen String nach einem Zeichen aus einer Gruppe von Zeichen
  • preg_match() - Führt eine Suche mit einem regulären Ausdruck durch