Modèle:Str len/Documentation
Ceci est la page de documentation de Modèle:Str len [modifier] [purger].
Cette sous-page contient les instructions et les catégories de son modèle d'origine et elle n'est pas destinée à être visualisée directement.
Ce modèle utilise le module String, un script écrit dans le langage de programmation Lua. Toute expérimentation devrait être conduite d'abord via sa sous-page bac à sable. Voir le projet Scribunto si vous voulez en savoir plus.
Utilisation
[modifier le code]Ce modèle retourne la longueur de la chaîne de caractères passée en paramètre. Alias : {{Longueur}}.
Exemples
[modifier le code]| Code | Résultat | Notes |
|---|---|---|
{{str len|foobar}}
|
6 | Utilisation de base. |
{{str len|café}}
|
4 | Les caractères UTF-8 (pouvant être encodés sur plusieurs octets) sont correctement comptés. |
{{str len|}}
|
0 | Si le paramètre est vide alors la longueur de la chaîne est égale à 0. |
Trim
[modifier le code]Par défaut, un « trim » est effectué sur le texte passé en paramètre. C'est généralement le fonctionnement voulu.
Il est possible de ne pas effectuer ce trim en ajoutant un paramètre trim=non. À utiliser seulement si nécessaire et en connaissance de cause.
| Code | Résultat |
|---|---|
{{str len| foobar }}
|
6 |
{{str len| foobar |trim=non}}
|
8 |
