explode

(PHP 4, PHP 5)

explode — Divide una cadena por otra

Descripción

array explode ( string $separador , string $cadena [, int $limite ] )

Devuelve una matriz de cadenas, cada una de las cuales es una subcadena de cadena formada mediante su división en las fronteras marcadas por la cadena separador . Si se especifica limite , la matriz devuelta contendrá un máximo de limite elementos con el último conteniendo el resto de la cadena .

Si separador es una cadena vacía (""), explode() devuelve un valor igual a FALSE. If separador contiene un valor que no está presente en cadena , la función explode() devuelve una matriz que contiene la cadena .

Si el parámetro limite es negativo, se devuelven todos los valores salvo el último limite . Este comportamiento se incluyó en la versión de PHP 5.1.0.

Aunque la función implode() por razones históricas puede aceptar sus parámetros en cualquier orden, no sucede lo mismo con la función explode(). Por tanto, se debe asegurar que el argumento separador se indique antes que el argumento cadena .

Note: El parámetro limite se incluyó en PHP 4.0.1.

Example#1 Ejemplos de explode()


<?php
// Ejemplo 1
$pizza  = "trozo1 trozo2 trozo3 trozo4 trozo5 trozo6";
$trozos = explode(" ", $pizza);
echo $trozos[0]; // trozo1
echo $trozos[1]; // trozo2

// Ejemplo 2
$datos = "usuario:*:1023:1000::/home/usuario:/bin/sh";
list($usuario, $contrasena, $uid, $gid, $gecos, $home, $shell) = explode(":", $datos);
echo $usuario;    // usuario
echo $contrasena; // *

?>

Example#2 Ejemplo del parámetro limite


<?php
$cadena = 'uno|dos|tres|cuatro';

// limite positivo
print_r(explode('|', $cadena, 2));

// limite negativo (desde PHP 5.1)
print_r(explode('|', $cadena, -1));
?>

El resultado del ejemplo seria:

Array
(
    [0] => uno
    [1] => dos|tres|cuatro
)
Array
(
    [0] => uno
    [1] => dos
    [2] => tres
)

Note: Esta función es segura binariamente.

See also preg_split(), spliti(), split(), strtok(), and implode().