Dislaimer | Kontakt | Sitemap

Hintergrund

Du bist hier: Tips » Scripte » PHP
PHP
Referenzliste

preg_split
PCRE-Funktionen

    Befehl:
array preg_split ( string $pattern , string $subject [, int $limit = -1 [, int $flags = 0 ]] )


    Parameter-Liste:
NameBeschreibung
patternDer Ausdruck, nach dem gesucht werden soll, als Zeichenkette.
subjectDie zu zerlegende Zeichenkette.
limitFalls angegeben, werden maximal limit Teilzeichenketten zurückgegeben, wobei der Rest der Zeichenkette in der letzten Teilzeichenkette abgelegt wird. Ein limit von -1, 0 oder NULL bedeutet "kein Limit" und wie es in PHP Standard ist, kann NULL verwendet werden um den Parameter flags zu überspringen.
flagsflags kann jede Kombination der folgenden Flags sein (verknüpft mit dem bitweisen | Operator):
NameBeschreibung
PREG_SPLIT_NO_EMPTYFalls dieses Flag gesetzt ist, werden von preg_split() nur die Teile zurückgegeben, die nicht leer sind.
PREG_SPLIT_DELIM_CAPTUREFalls dieses Flag gesetzt ist, werden auch die eingeklammerten Ausdrücke des Trennsymbol-Suchmusters erfasst und zurückgegeben.
PREG_SPLIT_OFFSET_CAPTUREFalls dieses Flag gesetzt ist, wird mit jeder gefundenen Übereinstimmung der dazugehörige Versatz in der Zeichenkette zurückgegeben. Beachten Sie, dass dies die Rückgabewerte in einem Array dahingehend ändert, dass jedes Element ein Array ist, das aus der übereinstimmenden Zeichenkette als Element 0 und deren Stelle in subject als Element 1 besteht.

    Rückgabewerte:
Gibt ein Array zurück, bestehend aus Teilzeichenketten der Zeichenkette subject, die an den auf das Suchmuster pattern passenden Stellen zerlegt wurde.

    Beschreibung:
Zerlegt die angegebene Zeichenkette anhand eines regulären Ausdrucks.


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

    Tips:
Tips:

Falls Sie die Leistung regulärer Ausdrücke nicht benötigen, können Sie stattdessen schnellere (wenngleich einfachere) Alternativen wie explode() oder str_split() verwenden.

Falls keine Übereinstimmungen gefunden wurden, wird ein Array mit nur einem Element zurückgegeben, das die übergebene Zeichenkette enthält.


    Siehe auch:
•  implode()
Verbindet Array-Elemente zu einem String
 
•  preg_match()
Führt eine Suche mit einem regulären Ausdruck durch
 
•  preg_match_all()
Führt eine umfassende Suche nach Übereinstimmungen mit regulärem Ausdruck durch
 
•  preg_replace()
Sucht und ersetzt mit regulären Ausdrücken
 
•  preg_last_error()
Liefert den Fehlercode der letzten PCRE RegEx-Auswertung
 

preg_split() - Beispiel: Eine Zeichenkette in ihre Bestandteile zerlegen

Eingabe: 
<?PHP
// zerlegt die Zeichenkette an Stellen mit beliebiger Anzahl von
// Kommata oder Leerzeichen, die " ", \r, \t, \n und \f umfassen
$schluesselwoerter = preg_split("/[\s,]+/", "hypertext language, programming");
print_r($schluesselwoerter);
?>


Ausgabe:
Array
(
    [0] => hypertext
    [1] => language
    [2] => programming
)

Beschreibung:
Version Beschreibung
4.3.0 Das Flag PREG_SPLIT_OFFSET_CAPTURE hinzugefügt.
4.0.5 Das Flag PREG_SPLIT_DELIM_CAPTURE hinzugefügt.
preg_split() - Beispiel 2: Eine Zeichenkette in einzelne Zeichen zerlegen

Eingabe: 
<?PHP
$str = 'string';
$zeichen = preg_split('//', $str, -1, PREG_SPLIT_NO_EMPTY);
print_r($zeichen);
?>


Ausgabe:
Array
(
    [0] => s
    [1] => t
    [2] => r
    [3] => i
    [4] => n
    [5] => g
)

Beschreibung:
Version Beschreibung
4.3.0 Das Flag PREG_SPLIT_OFFSET_CAPTURE hinzugefügt.
4.0.5 Das Flag PREG_SPLIT_DELIM_CAPTURE hinzugefügt.
preg_split() - Beispiel 3: Eine Zeichenkette in Übereinstimmungen mit dem Suchmuster und deren Versatz zerlegen

Eingabe: 
<?PHP
$str = 'hypertext language programming';
$zeichen = preg_split('/ /', $str, -1, PREG_SPLIT_OFFSET_CAPTURE);
print_r($zeichen);
?>


Ausgabe:
Array
(
    [0] => Array
        (
            [0] => hypertext
            [1] => 0
        )

    [1] => Array
        (
            [0] => language
            [1] => 10
        )

    [2] => Array
        (
            [0] => programming
            [1] => 19
        )

)

Beschreibung:
Version Beschreibung
4.3.0 Das Flag PREG_SPLIT_OFFSET_CAPTURE hinzugefügt.
4.0.5 Das Flag PREG_SPLIT_DELIM_CAPTURE hinzugefügt.
preg_replace
PCRE-Funktionen