explode

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

explode — Розбиває рядок за допомогою роздільника

Опис

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

Повертає масив рядків, отриманих розбиттям рядка stringс использованиемseparator як роздільник.

Список параметрів

separator

Розділювач.

string

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

limit

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

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

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

Зауваження :

До PHP 8.0 функцияimplode() приймала параметри у будь-якому порядку. Функція explode() ніколи цього не підтримувала: переконайтеся, що separator вказано перед аргументом string

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

Повертає масив (array) рядків (string), створений поділом параметра string за межами, зазначеними параметром separator

Якщо separator є порожнім рядком (""), explode() викидає ValueError. Якщо separator не міститься в string, і використовується негативний limit, то буде повернено порожній масив (array), інакше буде повернено масив, що містить stringЕсли значенияseparator з'являються на початку чи наприкінці string, зазначені значення будуть додані як порожнє значення масиву (array), або в першій або в останній позиції поверненого масиву (array) відповідно.

список змін

Версия	Опис
8.0.0	explode() тепер викидає TypeError, якщо параметр `separator` є порожнім рядком (`""`). Раніше замість виключення explode() повертала `false`

Приклади

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

Loading...

Приклад #2 Приклад значення, що повертається explode()

Loading...

Результат виконання наведеного прикладу:

array(1)
(
    [0] => string(5) "hello"
)
array(2)
(
    [0] => string(5) "hello"
    [1] => string(5) "there"
)
array(2)
(
    [0] => string(0) ""
    [1] => string(0) ""
)

Приклад #3 Приклади за допомогою параметра limit

Loading...

Результат виконання наведеного прикладу:

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

Примітки

Зауваження: Ця функція безпечна для обробки даних у двійковій формі.

Дивіться також

preg_split() - Розбиває рядок за регулярним виразом
str_split() - Перетворює рядок на масив
mb_split() - Розділяє рядки в багатобайтних кодуваннях через регулярний вираз
str_word_count() - Повертає інформацію про слова, що входять до рядка
strtok() - Розбиває рядок на токени
implode() - Об'єднує елементи масиву в рядок