explode

    (PHP 4, PHP 5, PHP 7, PHP 8)

    explode — Divide uma string com base em outra string

    Descrição

    explode(string $separator, string $string, int $limit = PHP_INT_MAX): array

    Retorna um array de strings, sendo que cada uma é uma sub-string da string, formado pela separação dela nos limites formados pela string informada em separator.

    Parâmetros

    separator

    A string que define o separador.

    string

    A string de entrada.

    limit

    Se limit estiver definido e for positivo, o array retornado conterá um máximo de limit elementos com o último elemento contendo todo o restante da string.

    Se limit for negativo, todos os componentes exceto os (último - limit) são retornados.

    Se limit for zero, é tratado como 1.

    Nota:

    Antes do PHP 8.0, implode() aceitava seus dois primeiros parâmetros em qualquer ordem. A função explode() nunca suportou isto: deve-se garantir que o parâmetro separator vem antes do parâmetro string.

    Valor Retornado

    Retorna um array de strings criado pela separação da string nos limites formados pelo parâmetro separator.

    Se separator for uma string vazia (""), explode() lança um ValueError. Se separator contiver um valor não contido em string e um valor negativo for usado em limit, um array vazio será retornado, caso contrário um array contendo string será retornado. Se valores de separator aparecerem no início ou no final da string, said values elementos de array vazios serão adicionados na posição inicial ou final do array retornado, respectivamente.

    Registro de Alterações

    Versão Descrição
    8.0.0 explode() agora lança um ValueError quando separator é informado com uma string vazia (""). Anteriormente, explode() retornava false nesse caso.

    Exemplos

    Exemplo #1 Exemplos de explode()

    <?php
    // Exemplo 1
    $pizza = "fatia1 fatia2 fatia3 fatia4 fatia5 fatia6";
    $fatias = explode(" ", $pizza);
    echo     $fatias[0], PHP_EOL; // fatia1
    echo $fatias[1], PHP_EOL; // fatia2

    // Exemplo 2
    $data = "foo:*:1023:1000::/home/foo:/bin/sh";
    list(    $user, $pass, $uid, $gid, $gecos, $home, $shell) = explode(":", $data);
    echo     $user, PHP_EOL; // foo
    echo $pass, PHP_EOL; // *
    ?>

    Exemplo #2 Exemplo de retorno de explode()

    <?php
    /*
    Uma string que não contém o separador simplesmente
    irá retornar um array de 1 elemento com a string original.
    */
    $input1 = "olá";
    $input2 = "olá,mundo";
    $input3 = ',';
    var_dump( explode( ',', $input1 ) );
    var_dump( explode( ',', $input2 ) );
    var_dump( explode( ',', $input3 ) );

    ?>

    O exemplo acima produzirá:

    array(1)
(
    [0] => string(3) "olá"
)
array(2)
(
    [0] => string(3) "olá"
    [1] => string(5) "mundo"
)
array(2)
(
    [0] => string(0) ""
    [1] => string(0) ""
)

    Exemplo #3 Exemplos do parâmetro limit

    <?php
    $str     = 'um|dois|três|quatro';

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

    // limite negativo
    print_r(explode('|', $str, -1));
    ?>

    O exemplo acima produzirá:

    Array
(
    [0] => um
    [1] => dois|três|quatro
)
Array
(
    [0] => um
    [1] => dois
    [2] => três
)

    Notas

    Nota: Esta função é compatível com dados binários.

    Veja Também

    • preg_split() - Divide uma string com base em expressão regular
    • str_split() - Converte uma string em um array
    • mb_split() - Divide uma string multibyte usando expressão regular
    • str_word_count() - Retorna informação sobre palavras usadas em uma string
    • strtok() - Divide uma string em tokens
    • implode() - Aglutina elementos de um array com uma string

    Melhore Esta Página

    Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
    ＋adicione uma nota

    Notas Enviadas por Usuários (em inglês) 4 notes

    up
    36
    Gerben
    3 years ago
    Note that an empty input string will still result in one element in the output array. This is something to remember when you are processing unknown input.

    For example, maybe you are splitting part of a URI by forward slashes (like "articles/42/show" => ["articles", "42", "show"]). And maybe you expect that an empty URI will result in an empty array ("" => []). Instead, it will contain one element, with an empty string:

    <?php

    $uri     = '';
    $parts = explode('/', $uri);
    var_dump($parts);

    ?>

    Will output:

    array(1) {
    [0]=>
    string(0) ""
    }

    And not:

    array(0) {
    }
    up
    14
    marc
    1 year ago
    If your data is smaller than the expected count with the list expansion:

    <?php
    $data     = "foo:*:1023:1000::/home/foo:/bin/sh";
    list(    $user, $pass, $uid, $gid, $gecos, $home, $shell,$nu) = explode(":", $data);
    ?>

    The result is a warning not an error:

    PHP Warning: Undefined array key 7 in ...

    The solution is to pad the array to the expected length:

    <?php
    $data     = "foo:*:1023:1000::/home/foo:/bin/sh";
    list(    $user, $pass, $uid, $gid, $gecos, $home, $shell,$nu) = array_pad( explode(":", $data), 8, "");
    // where 8 is the count of the list arguments
    ?>
    up
    12
    bocoroth
    4 years ago
    Be careful, while most non-alphanumeric data types as input strings return an array with an empty string when used with a valid separator, true returns an array with the string "1"!

    var_dump(explode(',', null)); //array(1) { [0]=> string(0) "" }
    var_dump(explode(',', false)); //array(1) { [0]=> string(0) "" }

    var_dump(explode(',', true)); //array(1) { [0]=> string(1) "1" }
    up
    2
    Alejandro-Ihuit
    2 years ago
    If you want to directly take a specific value without having to store it in another variable, you can implement the following:

    $status = 'Missing-1';

    echo $status_only = explode('-', $status)[0];

    // Missing
    ＋adicione uma nota
    To Top