(PHP 4, PHP 5)
ereg — Sucht Übereinstimmungen mit einem regulären Ausdruck
$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.
Diese Funktion ist seit PHP 5.3.0 DEPRECATED (veraltet). Sich auf diese Funktion zu verlassen ist in keiner Weise empfehlenswert.
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.
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.
| 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. |
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";
}
?>
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.
Hinweis:
Die Funktion preg_match(), die eine zu Perl kompatible Syntax regulärer Ausdrücke verwendet, ist häufig die schnellere Alternative zu ereg().