Submit a Pull Request Report a Bug

    explode

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

    explode — Divide uma string em strings

    Valor Retornado

    explode(string $delimiter, string $string, int $limit = ?): array

    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.

    Changelog

    Versão Descrição
    5.1.0 Suporte a limit negativo foi adicionado

    Exemplos

    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 produzirá:

    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.

    Veja Também

    ＋add a note

    User Contributed Notes 3 notes

    up
    19
    Gerben
    1 year 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
    10
    bocoroth
    2 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
    3
    Alejandro-Ihuit
    11 months 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
    ＋add a note
    To Top