Descrição

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

Converte uma string em um array.

Parâmetros

string: A string de entrada.
length: Comprimento máximo do pedaço.

Valor Retornado

Se o parâmetro opcional length for especificado, o array retornado será dividido em pedaços, sendo cada um deles com length de comprimento, exceto o pedaço final que pode ser mais curto se a string não for dividisível uniformemente. O length padrão é 1, o que significa que cada pedaço terá um byte de tamanho.

Erros/Exceções

Se length for menor que 1, uma exceção ValueError será lançada.

Registro de Alterações

Versão	Descrição
8.2.0	Se `string` estiver vazio, um array agora é retornado. Anteriormente, um array contendo uma única string vazia foi retornada.
8.0.0	Se `length` for menor que `1`, uma exceção ValueError será lançada agora; anteriormente, um erro de nível `E_WARNING` era gerado e a função retornava `false`.

Exemplos

Exemplo #1 Exemplos de uso de str_split()

<?php

$str = "Tchau Amigos";

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

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

?>

O exemplo acima produzirá:

Array
(
    [0] => T
    [1] => c
    [2] => h
    [3] => a
    [4] => u
    [5] =>
    [6] => A
    [7] => m
    [8] => i
    [9] => g
    [10] => o
    [11] => s
)

Array
(
    [0] => Tch
    [1] => au
    [2] => Ami
    [3] => gos
)

Notas

Nota:
str_split() dividirá em bytes, em vez de caracteres, ao lidar com uma string codificada em múltiplos bytes. mb_str_split() pode ser usada para dividir a string em pontos de código. grapheme_str_split() pode ser usada para dividir a string em grupos de grafema.

Veja Também

mb_str_split() - Dada uma string multibyte, retorna um array de seus caracteres
grapheme_str_split() - Separa uma string em um array
chunk_split() - Divide uma string em pedaços menores
preg_split() - Divide uma string com base em expressão regular
explode() - Divide uma string com base em outra string
count_chars() - Retorna informação sobre caracteres usados em uma string
str_word_count() - Retorna informação sobre palavras usadas em uma string
for