Modèle:Str len/Documentation

Un livre de Wikilivres.
Sauter à la navigation Sauter à la recherche
Template doc page.svg
Ceci est la sous-page de documentation du modèle {{Str len}} ; elle est insérée sur la page de celui-ci à l’aide du modèle {{Documentation}}. C’est également sur cette page que vous placerez les liens interwiki et les catégories du modèle.

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