CHOP |
Change l'opérateur |
| PHP 3+ |
Syntaxe
|
function chop($str)
|
|
function chop($str,$charlist)
|
Paramètres
| Nom |
Description |
| $str |
Ce paramètre permet d'indiquer la chaîne de caractères devant être traité |
| $charlist |
Ce paramètre permet d'indiquer les caractères allant être supprimé. Par défaut, voici les caractères éliminés : |
| "\0" (ASCII 0 (0x00)) |
Cette valeur permet d'indiquer le caractère nulle |
| "\t" (ASCII 9 (0x09) |
Cette valeur permet d'indiquer une tabulation |
| "\n" (ASCII 10 (0x0A) |
Cette valeur permet d'indiquer une nouvelle ligne |
| "\x0B" (ASCII 11 (0x0B)) |
Cette valeur permet d'indiquer la tabulation verticale |
| "\r" (ASCII 13 (0x0D) |
Cette valeur permet d'indiquer retour de chariot |
| " " (ASCII 32 (0x20) |
Cette valeur permet d'indiquer un espace |
Retour
| Valeur |
Description |
| valeur alphanumérique |
Cette valeur retourne le résultat de la chaîne de caractères sans les caractères à enlever à la fin de la chaîne de caractères. |
Description
Cette fonction enlève les dernières caractères d'espace.
Remarques
- Objectif principal : La fonction chop() en PHP sert à supprimer les espaces blancs ou autres caractères de fin d'une chaîne de caractères. En d'autres
termes, elle effectue un "trim" uniquement du côté droit de la chaîne, éliminant ainsi les caractères inutiles ou indésirables à la fin de celle-ci.
- Paramètres de la fonction : chop() prend un seul paramètre obligatoire, à savoir la chaîne de caractères dont vous souhaitez supprimer les caractères de
fin. Optionnellement, un deuxième paramètre peut être fourni pour spécifier les caractères à retirer (par défaut, ce sont les espaces blancs, les tabulations et les retours à la
ligne).
- Comportement par défaut : Si aucun deuxième paramètre n'est spécifié, chop() supprime les espaces blancs, les tabulations, les retours à la ligne (\n), les
retours chariots (\r) et les caractères de saut de ligne sous forme combinée (\r\n). Cela la rend particulièrement utile pour nettoyer des chaînes récupérées à partir de fichiers
ou de formulaires.
- Différence avec rtrim() : Bien que chop() soit similaire à la fonction rtrim(), ces deux fonctions ne sont pas tout à fait équivalentes. rtrim()
est la fonction standard de PHP pour retirer les caractères en fin de chaîne de caractères, tandis que chop() est un alias de rtrim(), c'est-à-dire que les
deux accomplissent la même tâche, mais chop() est une version plus ancienne de la fonction.
- Valeur de retour : La fonction retourne la chaîne modifiée, c'est-à-dire la chaîne d'origine avec les caractères de fin supprimés. Si la chaîne est déjà dépourvue
de ces caractères, la chaîne est retournée telle quelle sans modification.
- Utilisation dans les traitements de chaînes : chop() est particulièrement utile lorsqu'il faut préparer une chaîne de caractères avant de l'utiliser, notamment
lorsqu'il s'agit de nettoyer des entrées utilisateurs ou des données récupérées depuis des fichiers texte où des espaces ou des retours à la ligne peuvent être présents à
la fin.
- Comportement avec des caractères spécifiés : Si un deuxième paramètre est fourni à chop(), il sera traité comme une liste de caractères à supprimer. Par
exemple, chop($str, "abc") retirera tous les caractères "a", "b" ou "c" à la fin de la chaîne de caractères, jusqu'à ce qu'un caractère non spécifié soit rencontré.
- Limitation avec la suppression à droite uniquement : Il est important de noter que chop() ne supprime les caractères qu'à la fin de la chaîne de caractères,
pas au début. Si vous avez besoin de supprimer des caractères à la fois au début et à la fin d'une chaîne, vous devez utiliser trim(), permettant de supprimer les espaces
blancs et autres caractères indésirables sur les deux bords de la chaîne.
Références
PHP 4 - Guide du développeur, Edition First Interactive, Blake Schwendiman, 2002, ISBN: 2-84427-283-5, page 376 à 377
Dernière mise à jour : Mercredi, le 25 mars 2015
