str_split

(PHP 5, PHP 7, PHP 8)

str_split — Перетворює рядок на масив

Опис

str_split(string $string, int $length = 1): array

Перетворює рядок на масив.

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

string

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

length

Максимальна довжина фрагмента.

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

Якщо вказано необов'язковий параметр length, що повертається масив буде розбитий на фрагменти, кожен з яких матиме довжину length, За винятком останнього фрагмента, який може бути коротшим, якщо рядок ділиться нерівномірно. За замовчуванням параметр lengthравен тобто розмір кожного фрагмента буде один байт.

Помилки

Якщо параметр lengthменьше , буде викинута помилка ValueError

список змін

Версия	Опис
8.2.0	Якщо параметр string не заданий, тепер вертається порожній масив (array). Раніше повертався масив (array), що містить один порожній рядок
8.0.0	Тепер якщо параметр lengthменьше , буде викинута помилка ValueError; раніше, натомість видавалася помилка рівня E_WARNING, а функція повертала false

Приклади

Приклад #1 Приклад використання функції str_split()****

Loading...
▶

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

Array
(
    [0] => H
    [1] => e
    [2] => l
    [3] => l
    [4] => o
    [5] =>
    [6] => F
    [7] => r
    [8] => i
    [9] => e
    [10] => n
    [11] => d
)

Array
(
    [0] => Hel
    [1] => lo
    [2] => Fri
    [3] => end
)

Примітки

Зауваження :

Функцияstr_split() здійснює розбивку за байтами, а не за символами, у разі використання рядків у багатобайтних кодуваннях. Використовуйте функцію mb_str_split(), щоб розбити рядок кодових точок.

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

• mb_str_split() - Повертає масив символів заданого багатобайтового рядка
• chunk_split() - Розбиває рядок на фрагменти
• preg_split() - Розбиває рядок за регулярним виразом
• explode() - Розбиває рядок за допомогою роздільника
• count_chars() - Повертає інформацію про символи, що входять до рядка
• str_word_count() - Повертає інформацію про слова, що входять до рядка
• for