(PHP 4, PHP 5, PHP 7)
explode — Divide un string en varios string
$delimiter
, string $string
[, int $limit = PHP_INT_MAX
] ) : array
Devuelve un array de string, siendo cada uno un substring del
parámetro string formado por la división realizada
por los delimitadores indicados en el parámetro delimiter.
delimiterEl string delimitador.
stringEl string de entrada.
limit
Si el parámetro limit es positivo, el array devuelto contendrá
el máximo de limit elementos, 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 del último -limit.
Si el parámetro limit es cero,se tratará como 1.
Nota:
Aunque implode(), por razones históricas, puede aceptar los parámetros en cualquier orden, explode() no. Debe asegurarse de que el argumento
delimitervaya antes que el argumentostring.
Devuelve un array de string
creados por la división del parámetro string usando
los delimitadores indicados en el parámetro delimiter.
Si delimiter es un string vacío (""),
explode() devolverá FALSE.
Si delimiter contiene un valor que no
forma parte del parámetro string y se utiliza un
limit negativo, entonces devolverá un array vacío,
en caso contrario se devolverá un array que contiene el valor de
string.
| Versión | Descripción |
|---|---|
| 5.1.0 |
Se añadió soporte para limit negativo.
|
Ejemplo #1 Ejemplo de explode()
<?php
// Ejemplo 1
$pizza = "porción1 porción2 porción3 porción4 porción5 porción6";
$porciones = explode(" ", $pizza);
echo $porciones[0]; // porción1
echo $porciones[1]; // porción2
// Ejemplo 2
$datos = "foo:*:1023:1000::/home/foo:/bin/sh";
list($user, $pass, $uid, $gid, $gecos, $home, $shell) = explode(":", $datos);
echo $user; // foo
echo $pass; // *
?>
Ejemplo #2 Ejemplos de la devolución de explode()
<?php
/*
Un string que no contiene el delimitador simplemente
devolverá un array de longitud uno con el string original.
*/
$entrada1 = "hola";
$entrada2 = "hola,qué tal";
var_dump( explode( ',', $entrada1 ) );
var_dump( explode( ',', $entrada2 ) );
?>
El resultado del ejemplo sería:
array(1)
(
[0] => string(4) "hola"
)
array(2)
(
[0] => string(4) "hola"
[1] => string(8) "qué tal"
)
Ejemplo #3 Ejemplos del parámetro limit
<?php
$str = 'uno|dos|tres|cuatro';
// límite positivo
print_r(explode('|', $str, 2));
// líimte negativo (desde PHP 5.1)
print_r(explode('|', $str, -1));
?>
El resultado del ejemplo sería:
Array
(
[0] => uno
[1] => dos|tres|cuatro
)
Array
(
[0] => uno
[1] => dos
[2] => tres
)
Nota: Esta función es segura binariamente.