Function.stristr

Aus PHP-Wiki

stristr — Wie strstr(), aber ohne Rücksicht auf Groß- bzw. Kleinschreibung

Beschreibung

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

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 (Standardwert ist FALSE), 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

#1 stristr()

<?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()
• strrchr()
• substr()
• preg_match()