(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] => три )
Зауваження: Ця функція є бінарно безпечною.