explode
(PHP 4, PHP 5)
explode — Divide uma string em strings
Valor Retornado
Retorna uma matriz de strings, cada uma como substring de string formada pela divisão dela a partir do delimiter .
Parâmetros
- 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 .
Valor Retornado
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 .
Histórico
| Versão | Descrição |
|---|---|
| 5.1.0 | Suporte a limit negativo foi adicionado |
| 4.0.1 | O parâmetro limit foi adicionado |
Exemplos
Example#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; // *
?>
Example#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 )
Notas
Nota: Esta função é compatível com dados binários