(PHP 4, PHP 5)
explode — Divide una cadena en varias cadenas
$delimiter
, string $string
[, int $limit
] )
Devuelve un array de cadenas, siendo cada una de ellas una subcadena del
parámetro string formado por la división
según los delimitadores indicados en el parámetro delimiter.
delimiter
La cadena delimitadora.
string
La cadena de entrada.
limit
Si el parámetro limit es positivo, el array devuelto contendrá
el máximo de elementos en el limit y el último elemento
contendrá el resto del string.
Si el parámetro limit es negativo, se devolverán
todos los componentes a excepción el último -limit.
Si el parámetro limit es cero, actuará como si su valor fuera 1.
Aunque implode() por razones históricas puede
aceptar los parámetros en cualquier orden,
explode() no. Debe asegurarse de que el
argumento delimiter va antes que
el argumento string.
Devuelve un array de cadenass
creadas por la división del parámetro string usando
los limitadores indicados en el parámetro delimiter.
Si delimiter es una cadena vacía (""),
explode() devolverá FALSE.
Si delimiter contiene un valor que no
forma parte del parámetro string y se utiliza un
limit negativo, entonces se devolverá un array vacío,
en caso contrario se devolverá un array conteniendo el
string.
| Versión | Descripción |
|---|---|
| 5.1.0 |
Se añadió soporte para limit negativo.
|
| 4.0.1 |
Se añadió el parámetro limit.
|
Ejemplo #1 Ejemplo de explode()
<?php
// Ejemplo 1
$pizza = "piece1 piece2 piece3 piece4 piece5 piece6";
$pieces = explode(" ", $pizza);
echo $pieces[0]; // piece1
echo $pieces[1]; // piece2
// Ejemplo 2
$data = "foo:*:1023:1000::/home/foo:/bin/sh";
list($user, $pass, $uid, $gid, $gecos, $home, $shell) = explode(":", $data);
echo $user; // foo
echo $pass; // *
?>
Ejemplo #2 Ejemplos del retorno de explode()
<?php
/* Un string que no contiene el delimitador simplemente devolverá un array de un elemento con el string original. */
$input1 = "hello";
$input2 = "hello,there";
var_dump( explode( ',', $input1 ) );
var_dump( explode( ',', $input2 ) );
?>
El resultado del ejemplo sería:
array(1)
(
[0] => string(5) "hello"
)
array(2)
(
[0] => string(5) "hello"
[1] => string(5) "there"
)
Ejemplo #3 Ejemplos del parámetro limit
<?php
$str = 'one|two|three|four';
// positive limit
print_r(explode('|', $str, 2));
// negative limit (since PHP 5.1)
print_r(explode('|', $str, -1));
?>
El resultado del ejemplo sería:
Array
(
[0] => one
[1] => two|three|four
)
Array
(
[0] => one
[1] => two
[2] => three
)
Nota: Esta función es segura binariamente.