Modèle:Str len/Documentation

Documentation du modèle

Utilisation modifier

{{Str len|<texte>}}

Renvoie le nombre de caractères de <texte>, avec un maximum de 500 (c'est-à-dire 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

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 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. 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

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é.