CHUNK_SPLIT |
Fendre de gros morceau |
PHP 4+ |
Syntaxe
function chunk_split($body, $chunklen);
|
function chunk_split($body, $chunklen,$end);
|
Paramètres
Nom |
Description |
$body |
Ce paramètre permet d'indiquer la chaîne de caractères source |
$chunklen |
Ce paramètre permet d'indiquer la longueur des segments de chaîne de caractères. La valeur par défaut est 76. |
$end |
Ce paramètre permet d'indiquer les segments a insérer entre les segments de sous-chaîne de caractères |
Retour
Valeur |
Description |
chaîne de caractères |
Cette valeur indique la chaîne de caractères ayant subit le traitement spécifié. |
Description
Cette fonction permet de découper une chaîne de caractères en sous-chaîne de caractères d'une certaine longueur et place le résultat dans une chaîne
de caractères en utilisant une chaîne de caractères séparateur spécifié. Comme le base64 par exemple.
Remarques
- Objectif principal : La fonction chunk_split() en PHP permet de découper une chaîne de caractères en morceaux de taille spécifiée. Chaque morceau
est séparé par un séparateur, ce qui est particulièrement utile pour formater des données, comme des adresses de courriel ou des chaînes de texte longues, afin de les rendre plus
lisibles ou de respecter des contraintes spécifiques.
- Paramètres de la fonction : chunk_split() prend trois paramètres : la chaîne à découper, la taille du morceau (en nombre de caractères), et un séparateur
(étant une chaîne à insérer entre chaque morceau). Si le séparateur n'est pas spécifié, la fonction utilise par défaut un saut de ligne (\n).
- Comportement avec la taille des morceaux : Le deuxième paramètre définit la longueur des morceaux dans lesquels la chaîne sera divisée. Par exemple, si vous
spécifiez une taille de 76 et que votre chaîne a 100 caractères, elle sera coupée en morceaux de 76 caractères, avec un morceau supplémentaire pour les caractères restants. Cela
est souvent utilisé dans des formats comme MIME, où la longueur des lignes est une contrainte.
- Séparateur personnalisable : Le troisième paramètre de chunk_split() permet de spécifier un séparateur entre chaque morceau. Par exemple, au lieu du saut de
ligne par défaut, vous pouvez utiliser un espace, une virgule ou tout autre caractère ou séquence de caractères pour séparer les morceaux de la chaîne de caractères. Cela peut
être utile pour adapter le format de sortie en fonction des besoins spécifiques.
- Valeur de retour : chunk_split() retourne une nouvelle chaîne de caractères où la chaîne d'origine est découpée en morceaux, chacun suivi du séparateur spécifié.
Si la chaîne d'origine est déjà plus courte que la taille spécifiée, elle sera retournée telle quelle, sans être modifiée. Il est donc important de s'assurer que la chaîne a
une longueur suffisante pour être découpée.
- Utilisation courante pour les données encodées : Une utilisation fréquente de chunk_split() est dans le traitement des données encodées, notamment pour
l'encodage de contenu MIME. Par exemple, lorsqu'on encode un fichier en base64, les lignes encodées peuvent être coupées en morceaux de 76 caractères pour respecter les
spécifications MIME, et chunk_split() facilite ce processus.
- Limitation du traitement des caractères non affichables : Bien que chunk_split() soit utile pour découper des chaînes en morceaux de taille fixe, elle ne gère pas
les caractères non imprimables de manière spécifique. Par exemple, si la chaîne contient des caractères spéciaux ou de contrôle qui affectent la mise en forme, ils seront traités
comme n'importe quel autre caractère. Il peut être nécessaire de nettoyer ou d'encoder ces caractères avant de les passer à chunk_split().
- Utilisation dans la gestion des courriels : chunk_split() est aussi couramment utilisée lors de la gestion de pièces jointes dans des courriels. Par
exemple, lorsque vous devez envoyer un fichier encodé en base64 dans un courriel, la chaîne base64 peut être découpée en morceaux de taille adéquate pour être incluse dans
l'entête ou le corps de le courriel, en utilisant chunk_split() pour respecter les limites de taille des lignes imposées par certains serveurs de messagerie.
Références
PHP 4 - Guide du développeur, Edition First Interactive, Blake Schwendiman, 2002, ISBN: 2-84427-283-5, page 377
Dernière mise à jour : Mercredi, le 25 mars 2015