Edit Report a Bug

    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

    add a note add a note

    User Contributed Notes 3 notes

    up
    0
    Julian
    1 year ago
    The function str_split() is not 'aware' of words. Here is an adaptation of str_split() that is 'word-aware'.

    <?php

    $array     =  str_split_word_aware(
            'In the beginning God created the heaven and the earth. And the earth was without form, and void; and darkness was upon the face of the deep.',
            32
    );

    var_dump($array);

    /**
      * This function is similar to str_split() but this function keeps words intact; it never splits through a word.
      *
      * @return array<int, string>
      */
    function str_split_word_aware(string $string, int $maxLengthOfLine): array
    {
        if (    $maxLengthOfLine <= 0) {
            throw new     RuntimeException(sprintf('The function %s() must have a max length of line at least greater than one', __FUNCTION__));
        }
       
            $lines = [];
            $words = explode(' ', $string);

            $currentLine = '';
            $lineAccumulator = '';
        foreach (    $words as $currentWord) {

                $currentWordWithSpace = sprintf('%s ', $currentWord);
                $lineAccumulator .= $currentWordWithSpace;
            if (    strlen($lineAccumulator) < $maxLengthOfLine) {
                    $currentLine = $lineAccumulator;
                continue;
            }

                $lines[] = $currentLine;

                // Overwrite the current line and accumulator with the current word
                $currentLine = $currentWordWithSpace;
                $lineAccumulator = $currentWordWithSpace;
        }

        if (    $currentLine !== '') {
                $lines[] = $currentLine;
        }

        return     $lines;
    }

    ?>

    OUTPUT:

    <?php

    array(5) {
      [    0]=> string(29) "In the beginning God created "
          [1]=> string(30) "the heaven and the earth. And "
          [2]=> string(28) "the earth was without form, "
          [3]=> string(27) "and void; and darkness was "
          [4]=> string(27) "upon the face of the deep. "
    }

    ?>
    up
    -7
    lskatz at gmail dot com
    16 years ago
    A good use of str_split is reverse translating an amino acid sequence.

    <?php
    /* reverse translate an aa sequence using its dna counterpart */
    function reverseTranslate($aaSeq,$ntSeq){
          $nt=str_split($ntSeq,3);
          $aa=str_split($aaSeq,1);
          $gapChar=array('*','-');

          $numAa=count($aa);
          $ntIndex=0;
          $newNtSeq="";
      for(    $i=0;$i<$numAa;$i++){
            // if the aa is a gap, then just put on a gap character
            if(in_array($aa[$i],$gapChar)){
              $newNtSeq.='---';
        }
        else{
              $newNtSeq.=$nt[$ntIndex];
              $ntIndex++;
        }
      }
      return     $newNtSeq;
    }
    ?>
    up
    -7
    alex-glebe at mail dot ru
    1 year ago
    Empty string Does'n returns Empty array!

    $arr0 = str_split("");
    print_r($arr0);

    Array
    (
        [0] =>
    )
    add a note add a note
    To Top