explode

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

explodeРозбиває рядок на підрядки

Опис

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

Повертає масив рядків, кожен з яких є підрядком рядка string, який був поділений за допомогою роздільника delimiter.

Параметри

delimiter

Роздільник.

string

Вхідний рядок.

limit

Якщо параметр limit встановлений і мість додатнє число, вихідний масив міститиме максимум limit елементів. А останній елемент міститиме залишок рядка string.

Якщо параметр limit містить від'ємне число, повернуться всі елементи окрім останніх -limit.

Якщо параметр limit дорівнює нулю, то він розцінюється як 1.

Зауваження:

На відміну від implode(), яка з історичних причин може приймати параметри у будь-якому порядку, для explode() це недопустимо. Ви повинні переконатися, що аргумент delimiter знаходиться перед аргументом string.

Значення, що повертаються

Повертає масив (array) підрядків (string) створених шляхом поділу string на кордонах, заданих параметром delimiter.

Якщо delimiter є пустим рядком string (""), explode() поверне false. Якщо delimiter містить значення, якого немає в string а також коли парамерт limit містить від'ємне значення - повертається порожній масив array. В інакшому випадку повертається масив array, який містить оригінальний рядок string.

Журнал змін

Версія Опис
5.1.0 Додано підтримку від'ємного значення параметра limit

Приклади

Приклад #1 Використання explode()

<?php
// Приклад 1
$pizza = "частина1 частина2 частина3 частина4 частина5 частина6";
$pieces = explode(" ", $pizza);
echo
$pieces[0]; // частина1
echo $pieces[1]; // частина2

// Приклад 2
$data = "foo:*:1023:1000::/home/foo:/bin/sh";
list(
$user, $pass, $uid, $gid, $gecos, $home, $shell) = explode(":", $data);
echo
$user; // foo
echo $pass; // *

?>

Приклад #2 explode() Повернення результату

<?php
/*
Рядок, який не містить роздільника,
просто поверне масив з одним значенням оригінального рядка.
*/
$input1 = "Привіт";
$input2 = "Привіт, народе!";
$input3 = ',';
var_dump( explode( ',', $input1 ) );
var_dump( explode( ',', $input2 ) );

?>

Поданий вище приклад виведе:

array(1)
(
    [0] => string(6) "Привіт"
)
array(2)
(
    [0] => string(6) "Привіт"
    [1] => string(8) " народе!"
)
array(2)
(
    [0] => string(0) ""
    [1] => string(0) ""
)

Приклад #3 Використання limit

<?php
$str
= 'один|два|три|чотири';

// додатній ліміт
print_r(explode('|', $str, 2));

// від'ємний ліміт (з версії PHP 5.1)
print_r(explode('|', $str, -1));
?>

Поданий вище приклад виведе:

Array
(
    [0] => один
    [1] => два|три|чотири
)
Array
(
    [0] => один
    [1] => два
    [2] => три
)

Примітки

Зауваження: Ця функція є бінарно безпечною.

Прогляньте також