stristr

(PHP 4, PHP 5)

stristr — Wie 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($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
  • stripos() - Findet das erste Vorkommen eines Teilstrings in einem String, unabhängig von Groß- und Kleinschreibung
  • strpbrk() - Durchsucht einen String nach einem Zeichen aus einer Gruppe von Zeichen
  • preg_match() - Führt eine Suche mit einem regulären Ausdruck durch