Modèle:Str len/Documentation
Utilisation
[modifier le wikicode]{{Str len|<texte>}}
Renvoie le nombre de caractères de <texte>, avec un maximum de 500 (c-à-d si <texte> est plus long que 500 caractères, il renvoie 500).
Note: il est souvent préférable d’utiliser les modèles {{Str ≥ len}} et similaires[1] (liste ci-dessous) car ils utilisent moins de ressources du serveur, et peuvent également rendre le code plus simple.
Exemples
[modifier le wikicode]Si le paramètre est vide ou non défini, il est considéré de longueur nulle :
{{Str len}}→ 0{{Str len|}}→ 0{{Str len| }}→ 0
Le résultat sera correct, même si le texte contient des espaces, ressemble à un nombre ou comprend des caractères spéciaux :
{{Str len| ab cde }}→ 6
{{Str len| 1234567 }}→ 7
{{Str len| café åäö }}→ 8
Le modèle peut compter jusqu’à 500 caractères :
{{Str len| Texte de 499 caractères ... }}→ 499{{Str len| Texte de 1000 caractères... }}→ 500
Détails techniques
[modifier le wikicode]Le logiciel MediaWiki n’a pas de parser function pour mesurer la longueur d’une chaîne de caractères, et le faire comme ceci est très lourd pour les serveurs ; ainsi ce modèle est optimisé autant que possible, mais il reste préférable d’utiliser {{Str ≥ len}} et similaires[1].
C’est le sous-modèle {{Str len/core}} qui effectue la majeure partie du travail.
- ↑ 1,0 et 1,1 Ceux-ci ne sont pas encore importés sur Wikilivres ; faites la demande à un administrateur en cas de besoin.
Voir aussi
[modifier le wikicode]Modèles réduisant la longueur du texte :
- {{Str left}} — Renvoie la partie gauche du texte.
- {{Str right}} — Renvoie la partie droite du texte.
- {{Str sub long}} — Réduit le texte à un certain nombre de caractères en partant du n-ième (inférieur à 100).
Modèles pour l’analyse :
- {{Str index any}} — Renvoie le n-ième caractère (sauf espace).
- {{Str len}} — Renvoie la longueur du texte ; fonctionne jusqu’à 500 caractères.
Modèle comparant la longueur du texte à un nombre :
- {{Str ≥ len}} — Pour vérifier si le texte est plus long ou égal au nombre donné.