(PHP 4, PHP 5, PHP 7)
explode — Divide uma string em strings
$delimiter
, string $string
[, int $limit
] )
Retorna uma matriz de strings, cada uma como substring de
string
formada pela divisão dela
a partir do delimiter
.
delimiter
O delimitador.
string
A string de entrada.
limit
Se limit
é definido, o array retornado irá conter
o máximo de elementos igual a limit
com o último
elemento contendo o resto da string
.
Se o parâmetro limit
é negativo, todos componentes
exceto o último -limit
são retornados.
Ainda que implode() pode por razões históricas
aceitar seus parâmetros em uma das duas ordens,
explode() não pode. Você deve assegurar que
o argumento delimiter
vem antes do argumento
string
.
Se delimiter
é uma string vazia (""),
explode() irá retornar FALSE
. Se
delimiter
contém um valor que não contém em
string
, então explode() irá
retornar um array contendo string
.
Versão | Descrição |
---|---|
5.1.0 |
Suporte a limit negativo foi adicionado
|
4.0.1 |
O parâmetro limit foi adicionado
|
Exemplo #1 explode() exemplos
<?php
// Example 1
$pizza = "piece1 piece2 piece3 piece4 piece5 piece6";
$pieces = explode(" ", $pizza);
echo $pieces[0]; // piece1
echo $pieces[1]; // piece2
// Example 2
$data = "foo:*:1023:1000::/home/foo:/bin/sh";
list($user, $pass, $uid, $gid, $gecos, $home, $shell) = explode(":", $data);
echo $user; // foo
echo $pass; // *
?>
Exemplo #2 Exemplos de 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));
?>
O exemplo acima irá imprimir:
Array ( [0] => one [1] => two|three|four ) Array ( [0] => one [1] => two [2] => three )
Nota: Esta função é binary-safe.