(PHP 4, PHP 5, PHP 7, PHP 8)
explode — Розбиває рядок на підрядки
Повертає масив рядків, кожен з яких є підрядком
рядка 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] => три
)
Зауваження: Ця функція є бінарно безпечною.