(PHP 5, PHP 7, PHP 8)
str_split — Converte uma string em um array
stringA string de entrada.
lengthComprimento máximo do pedaço.
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.
Se length for menor que 1,
uma exceção ValueError será lançada.
| 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.
|
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
)
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.