php-homepage.de - Die deutschsprachige Ressource für PHP und MySQL- Manual

Beschreibung

string stristr ( string $haystack , mixed $needle [, bool $before_needle = false ] )

Gibt den String haystack ab dem ersten Vorkommen von needle bis zum Ende zurück.

Parameter-Liste

haystack: Die Zeichenkette, in der gesucht werden soll.
needle: Ist needle kein String, wird der Parameter in einen Integerwert konvertiert, der dem Ordinalwert des Zeichens entspricht.
before_needle: Wenn der Wert auf TRUE gesetzt ist, gibt stristr() den Teil von haystack vor dem ersten Auftreten von needle zurück.

needle und haystack werden ohne Rücksicht auf Groß- oder Kleinschreibung untersucht.

Rückgabewerte

Gibt den gefundenen Teilstring zurück. Wenn needle nicht gefunden wurde, gibt die Funktion FALSE zurück.

Changelog

Version	Beschreibung
5.3.0	Der optionale Parameter `before_needle` wurde hinzugefügt.
4.3.0	stristr() ist jetzt Binary safe.

Beispiele

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
?>

Anmerkungen

Hinweis: Diese Funktion ist binary safe.

Siehe auch

strstr() - Findet das erste Vorkommen eines Strings
strrchr() - Sucht das letzte Vorkommen eines Zeichens in einem String
substr() - Gibt einen Teil eines Strings zurück
preg_match() - Führt eine Suche mit einem regulären Ausdruck durch