Description

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

Convertit une chaîne de caractères en tableau.

Liste de paramètres

string: La chaîne d'entrée.
length: Longueur maximale de chaque élément.

Valeurs de retour

Si le paramètre optionnel length est spécifié, le tableau retourné sera découpé en sous-parties, chacune de taille length, à l'exception de la dernière sous-partie qui peut être plus courte si la chaîne ne se divise pas de manière égale. La valeur par défaut de length est 1, ce qui signifie que chaque sous-partie aura une taille d'un octet.

Erreurs / Exceptions

Si length est plus petit que 1, une ValueError sera déclenchée.

Historique

Version	Description
8.2.0	Si `string` est vide, un tableau vide est désormais retourné. Auparavant, un tableau contenant une seule chaîne vide était retourné.
8.0.0	Si `length` est plus petit que `1`, une ValueError sera déclenchée; auparavant, une erreur de type `E_WARNING` était émise, et la fonction retournait `false`.

Exemples

Exemple #1 Exemple avec str_split()

<?php

$str = "Hello Friend";

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

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

?>

L'exemple ci-dessus va afficher :

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
)

Notes

Note:
str_split() va effectuer la découpe dans les bits, plutôt que dans les caractères lors de l'utilisation avec une chaîne de caractères encodée en multioctets. mb_str_split() peut être utilisé pour diviser la chaîne en points de code. grapheme_str_split() peut être utilisé pour diviser la chaîne en clusters de graphèmes.

Voir aussi

mb_str_split() - Pour une chaîne multi-octets donnée, renvoie un tableau de ses caractères
grapheme_str_split() - Sépare une chaîne en un tableau
chunk_split() - Scinde une chaîne
preg_split() - Éclate une chaîne par expression rationnelle
explode() - Scinde une chaîne de caractères en segments
count_chars() - Retourne des statistiques sur les caractères utilisés dans une chaîne
str_word_count() - Compte le nombre de mots utilisés dans une chaîne
for