(PHP 4, PHP 5, PHP 7)
explode — Teilt eine Zeichenkette anhand einer Zeichenkette
$delimiter
, string $string
[, int $limit = PHP_INT_MAX
] ) : array
Gibt ein Array aus Strings zurück, die jeweils Teil von
string sind. Die Abtrennung erfolgt dabei an der
mit delimiter angegebenen Zeichenkette.
delimiterDie Begrenzungszeichenkette.
stringDie Eingabezeichenkette.
limit
Ist der Parameter limit angegeben und positiv,
enthält das zurückgegebene Array maximal limit
Elemente, wobei das letzte Element den Rest von
string beinhaltet.
Ist der Parameter limit negativ, werden alle
Teilstrings bis auf die letzten -limit Teile
zurückgegeben.
Wenn der Parameter limit gleich 0 ist,
wird er wie 1 behandelt.
Hinweis:
Obgleich implode() aus historischen Gründen die Parameter in anderer Reihenfolge akzeptiert, verarbeitet explode() ausschließlich die hier angegebene Reihenfolge. Stellen Sie daher sicher, dass Sie den Parameter
delimitervor dem Parameterstringnotieren.
Gibt ein array von strings zurück, die
durch Aufsplitten des string Parameters an
Begrenzungen durch delimiter erzeugt werden.
Ist delimiter ein leerer String (""), so gibt
explode() FALSE zurück. Enthält
delimiter einen Wert, der nicht in
string vorkommt und wird ein negativer Wert für
limit verwendet, wird ein leeres array
zurückgegeben. Für alle anderen Werte von limit
wird ein array zurückgegeben, das den string
als einziges Element enthält.
| Version | Beschreibung |
|---|---|
| 5.1.0 |
Die Unterstützung für negative limit-Werte
wurde hinzugefügt.
|
Beispiel #1 explode()-Beispiele
<?php
// Beispiel 1
$pizza = "Teil1 Teil2 Teil3 Teil4 Teil5 Teil6";
$teile = explode(" ", $pizza);
echo $teile[0]; // Teil1
echo $teile[1]; // Teil2
// Beispiel 2
$data = "foo:*:1023:1000::/home/foo:/bin/sh";
list($user, $pass, $uid, $gid, $gecos, $home, $shell) = explode(":", $data);
echo $user; // foo
echo $pass; // *
?>
Beispiel #2 explode() Rückgabe Beispiel
<?php
/*
Eine Zeichenkette, die nicht das Trennzeichen enthält, wird einfach
ein ein-elementiges Array mit der ursprünglichen Zeichenkette liefern.
*/
$input1 = "hallo";
$input2 = "hallo,da";
$input3 = ',';
var_dump( explode( ',', $input1 ) );
var_dump( explode( ',', $input2 ) );
var_dump( explode( ',', $input3 ) );
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
array(1)
(
[0] => string(5) "hallo"
)
array(2)
(
[0] => string(5) "hallo"
[1] => string(5) "da"
)
array(2)
(
[0] => string(0) ""
[1] => string(0) ""
)
Beispiel #3 limit-Parameterbeispiele
<?php
$str = 'eins|zwei|drei|vier';
// positiver Wert in "limit"
print_r(explode('|', $str, 2));
// negative Wert in "limit" (ab PHP 5.1)
print_r(explode('|', $str, -1));
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Array
(
[0] => eins
[1] => zwei|drei|vier
)
Array
(
[0] => eins
[1] => zwei
[2] => drei
)
Hinweis: Diese Funktion ist binary safe.