Du bist hier: Tips » Scripte » PHP
PHP
Referenzliste

stristr

String-Funktionen

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


    Parameter-Liste:
NameBeschreibung
haystackDie Zeichenkette, in der gesucht werden soll.
needleIst needle kein String, wird der Parameter in einen Integerwert konvertiert, der dem Ordinalwert des Zeichens entspricht.
before_needleWenn 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 Gross- oder Kleinschreibung untersucht.

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

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


    Aktiv in Version:
(PHP 4, PHP 5, PHP 7)

    Hinweis:
Hinweis:

Diese Funktion ist binary safe.


    Siehe auch:
Findet das erste Vorkommen eines Strings
 
Sucht das letzte Vorkommen eines Zeichens in einem String
 
Gibt einen Teil eines Strings zurück
 
Führt eine Suche mit einem regulären Ausdruck durch
 

stristr() - Beispiel:


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


Beschreibung:
Mit stristr() kann man innerhalb einer Zeichenkette (haystack) nach einem String oder einem einzelnen Zeichen (needle) suchen. Bei der Untersuchung wird Gross- und Kleinschreibung ignoriert. Als Ergebnis gibt die Funktion die Zeichenkette ab dem ersten Vorkommen des gesuchten Zeichens bzw. des gesuchten Strings zur�ck. Wird f�r needle eine Zahl angegeben, so sucht die Funktion das Zeichen mit dem entsprechenden ASCII-Wert. Wird kein Suchtreffer ermittelt, so gibt die Funktion false zur�ck. Im unteren ersten Beispiel wurde nach einer Zeichenkette gesucht, w�hrend bei dem zweiten zu untersuchenden String die Zahl 105 (entspricht in der ASCII-Tabelle dem Buchstaben i) als Suchkriterium angegeben wurde.

Beschreibung:
Version Beschreibung
5.3.0 Der optionale Parameter before_needle wurde hinzugefügt.
4.3.0 stristr() ist jetzt Binary safe.
stristr() - Beispiel 2: Prüfen, ob ein String gefunden wurde oder nicht


Eingabe:
<?php
  $string = 'Hallo Welt!';
  if(stristr($string, 'Erde') === FALSE) {
    echo '"Erde" nicht gefunden';
  }
// Ausgabe: "Erde" nicht gefunden
?>


Beschreibung:
Version Beschreibung
5.3.0 Der optionale Parameter before_needle wurde hinzugefügt.
4.3.0 stristr() ist jetzt Binary safe.
stristr() - Beispiel 3: Verwendung eines Wertes, der kein String ist


Eingabe:
<?php
  $string = 'APFEL';
  echo stristr($string, 97); // 97 = kleines a
// Ausgabe: APFEL
?>


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