ereg

(PHP 4, PHP 5)

ereg — Sucht Übereinstimmungen mit einem regulären Ausdruck

Beschreibung

int ereg ( string $pattern , string $string [, array &$regs ] )

Sucht in string unter Berücksichtigung der Groß- und Kleinschreibung nach Übereinstimmungen mit dem regulären Ausdruck, der in pattern angegeben wurde.

Warnung

Diese Funktion ist seit PHP 5.3.0 DEPRECATED (veraltet). Sich auf diese Funktion zu verlassen ist in keiner Weise empfehlenswert.

Parameter-Liste

pattern

Regulärer Ausdruck mit Berücksichtigung der Groß- und Kleinschreibung

string

Die zu durchsuchende Zeichenkette

regs

Wenn Übereinstimmungen mit eingeklammerten Teilzeichenketten von pattern gefunden werden und die Funktion mit dem dritten Argument regs aufgerufen wurde, werden die Übereinstimmungen in den Elementen des Arrays regs gespeichert.

$regs[1] enthält die Teilzeichenkette der ersten Klammer, $regs[2] die Teilzeichenkette der zweiten usw. $regs[0] enthält bei Übereinstimmung mit string eine Kopie der kompletten Zeichenkette string.

Rückgabewerte

Gibt die Länge der übereinstimmenden Zeichenkette zurück, falls in string eine Übereinstimmung mit pattern gefunden wurde oder FALSE, wenn keine Übereinstimmung gefunden wurde oder wenn ein Fehler aufgetreten ist.

Falls der optionale Parameter regs nicht übergeben wurde oder die Länge der übereinstimmenden Zeichenkette 0 ist, gibt diese Funktion 1 zurück.

Changelog

Version Beschreibung
4.1.0 Bis (und inklusive) PHP 4.1.0 wird $regs mit genau zehn Elementen gefüllt, auch wenn es tatsächlich mehr oder weniger Übereinstimmungen mit den eingeklammerten Teilzeichenketten gibt. Dies wirkt sich aber nicht auf ereg()s Fähigkeit aus, mehr übereinstimmende Teilzeichenketten zu finden. Falls keine Übereinstimmungen gefunden werden, wird $regs nicht von ereg() verändert.

Beispiele

Beispiel #1 ereg()-Beispiel

Das folgende Code-Schnipsel mimmt ein Datum im ISO-Format (JJJJ-MM-TT) und gibt es im Format TT.MM.JJJJ aus:

<?php
if (ereg ("([0-9]{4})-([0-9]{1,2})-([0-9]{1,2})", $date, $regs)) {
    echo "$regs[3].$regs[2].$regs[1]";
} else {
    echo "Ungültiges Datumsformat: $date";
}
?>

Anmerkungen

Hinweis:

Seit PHP 5.3.0 ist die regex-Erweiterung zugunsten der PCRE-Erweiterung als veraltete markiert. Ein Aufruf dieser Funktion wird eine E_DEPRECATED-Notice ausgeben. Sie können sich die Liste der Unterschiede ansehen, wenn Sie Hilfe beim Umstieg auf PCRE benötigen.

Tipp

ereg() ist ab PHP 5.3.0 veraltet. Verwenden Sie stattdessen preg_match().

Siehe auch

  • eregi() - Sucht Übereinstimmung mit regulärem Ausdruck ohne Berücksichtigung von Groß-/Kleinschreibung
  • ereg_replace() - Ersetzt einen regulären Ausdruck
  • eregi_replace() - Ersetzt einen regulären Ausdrück ohne Berücksichtigung von Groß-/Kleinschreibung
  • preg_match() - Führt eine Suche mit einem regulären Ausdruck durch
  • strpos() - Sucht das erste Vorkommen des Suchstrings
  • strstr() - Findet das erste Vorkommen eines Strings
  • quotemeta() - Quoten von Meta-Zeichen