str_split

(PHP 5, PHP 7, PHP 8)

str_splitПреобразует строку в массив

Описание

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

Преобразует строку в массив.

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

string

Входная строка.

length

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

Возвращаемые значения

Если указан необязательный параметр length, возвращаемый массив будет разбит на фрагменты, каждый из которых будет иметь длину length, за исключением последнего фрагмента, который может быть короче, если строка делится неравномерно. По умолчанию параметр length равен 1, то есть размер каждого фрагмента будет один байт.

Ошибки

Если параметр length меньше 1, будет выброшена ошибка ValueError.

Список изменений

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

Примеры

Пример #1 Пример использования str_split()

<?php

$str
= "Hello Friend";

$arr1 = str_split($str);
$arr2 = str_split($str, 3);

print_r($arr1);
print_r($arr2);

?>

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

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