Modèle:Str ≥ len/Documentation

Documentation du modèle

Ceci est la page de documentation de Modèle:Str ≥ len. [rafraichir] • [modifier] • [historique] • [préproduction] • [tests unitaires]

Utilisation

Ce modèle permet de renvoyer un résultat différent en fonction de la longueur d’un texte.

{{Str ≥ len|<texte>|<longueur>|<si plus grand ou égal>|<si plus petit>}}

Paramètres

1 = un texte (maximum 500 caractères).
2 = un nombre (maximum 500).
3 = résultat renvoyé si la longueur du texte (le nombre de caractères) est supérieure ou égale au nombre.
4 = (optionnel) résultat renvoyé si la longueur du texte est inférieure au nombre.

Si le texte donné est vide ou non défini, il sera considéré comme de longueur nulle.

Si <longueur> est inférieure à 0, elle sera considérée comme étant 0 ; Si <longueur> est supérieure à 500, elle sera considérée comme étant 500 ;

Par conséquent un texte de 500 caractères ou plus donnera toujours la résultat <si plus grand ou égal>, quelle que soit la valeur de <longueur>.

Exemples

{{Str ≥ len | abcde | 4
 | plus long ou de longueur égale à 4
 | plus court que 4
}}

Si un des paramètres contient ou est susceptible de contenir le caractère « = », il faudra explicitement indiquer le numéro du paramètre :

{{str ≥ len 
 | 1 = ab=cde 
 | 2 = 100  <!-- pas nécessaire ici, mais présentation homogène -->
 | 3 = Égal (=) ou plus long
 | 4 = Plus court, pas =
}}

Détails techniques

Ce modèle aurait pu être nommé {{str >= len}} ou {{str < len}}, mais ceux-ci ne peuvent fonctionner avec MediaWiki.

Même si c’est un modèle de manipulation de texte, son code est très efficace (alors que certains autres modèles de manipulation de texte sont probablement si lourds pour les serveurs qu’on ne devrait peut-être pas les utiliser).

Voir aussi

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