(PHP 5, PHP 7, PHP 8)
str_split — Converte uma string em um array
string
A string de entrada.
length
Comprimento 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.