String-Funktionen
PHP Manual

stristr

(PHP 4, PHP 5, PHP 7)

stristrWie strstr(), aber unabhängig von Groß- bzw. Kleinschreibung

Beschreibung

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

Gibt den String haystack ab dem ersten Vorkommen (inklusive) 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 (ohne needle selbst).

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($string97); // 97 = kleines a
// Ausgabe: APFEL
?>

Anmerkungen

Hinweis: Diese Funktion ist binary safe.

Siehe auch


String-Funktionen
PHP Manual