Кышкар:Str len/Документаций велыжын важшым ончымаш

{{documentation subpage}}
{{used in system}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->

This is the {{tl|str len}} meta-template.

It takes a string as parameter and returns its length. It can count up to 500 in length, and returns 500 for strings that are too long.

'''Note!''' For most usage cases it is much easier and costs much less server resources to use {{tl|str ≥ len}} or one of its sister templates. See the [[#See also|see also]] section below.

=== Examples ===

If the parameter is empty or undefined it is considered to be of zero length: 

:<code><nowiki>{{str len}}</nowiki></code> returns {{str len}}
:<code><nowiki>{{str len|}}</nowiki></code> returns {{str len|}}
:<code><nowiki>{{str len| }}</nowiki></code> returns {{str len| }}

It counts the length correctly, even if the string contains spaces, looks like a number, or contains special characters:

:<code><nowiki>{{str len| ab cde }}</nowiki></code> returns {{str len| ab cde }}

:<code><nowiki>{{str len| 1234567 }}</nowiki></code> returns {{str len| 1234567 }}

:<code><nowiki>{{str len| café åäö }}</nowiki></code> returns {{str len| café åäö }}

It can measure strings up to 500 in length, and returns 500 for strings that are too long:

:<code><nowiki>{{str len| 499-characters... }}</nowiki></code> returns {{str len| abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi }}
:<code><nowiki>{{str len| 1000-characters... }}</nowiki></code> returns {{str len| abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghi abcdefghij }}

=== Technical details ===

MediaWiki has no parser function or magic word to measure string lengths. And measuring string length using template code is very heavy on the servers. Thus this template is as optimised as possible. But you should consider using {{tl|str ≥ len}} instead, since for most usage cases it is much easier to use and it costs much less server resources.

This template calls {{tl|str len/core}} which does most of the work. For documentation on the internal workings of these two templates see /core. The [[Template talk:Str len|talk page]] might also have more details.

=== See also ===

{{string templates see also}}

<includeonly>
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Категорий:String manipulation templates|{{PAGENAME}}]]

[[ab:Ашаблон:Str len]]
[[ar:قالب:Str len]]
[[as:সাঁচ:Str len]]
[[az:Şablon:Str len]]
[[ba:Ҡалып:Str len]]
[[bar:Vorlage:Str len]]
[[be:Шаблон:Str len]]
[[bg:Шаблон:Str len]]
[[bs:Šablon:Niz dužina]]
[[ca:Plantilla:Str len]]
[[cv:Шаблон:Str len]]
[[de:Vorlage:Str len]]
[[diq:Şablon:Str len]]
[[dsb:Pśedłoga:Str len]]
[[en:Template:Str len]]
[[eo:Ŝablono:Lin longo]]
[[es:Plantilla:Str len]]
[[fa:الگو:Str len]]
[[fr:Modèle:Str len]]
[[gag:Şablon:Str len]]
[[gd:Teamplaid:Str len]]
[[gu:ઢાંચો:Str len]]
[[gv:Clowan:Str len]]
[[hif:Template:Str len]]
[[hsb:Předłoha:Str len]]
[[id:Templat:Str len]]
[[kk:Үлгі:Str len]]
[[km:ទំព័រគំរូ:Str len]]
[[ko:틀:Str len]]
[[la:Formula:Str len]]
[[lb:Schabloun:Str len]]
[[lv:Veidne:Str len]]
[[it:Template:Str len]]
[[ja:Template:Str len]]
[[mr:साचा:Str len]]
[[ne:ढाँचा:Str len]]
[[no:Mal:Str len]]
[[or:ଛାଞ୍ଚ:Str len]]
[[os:Шаблон:Str len]]
[[pt:Predefinição:Str len]]
[[ru:Шаблон:Str len]]
[[sa:फलकम्:Str len]]
[[sk:Šablóna:Str len]]
[[sl:Predloga:Str len]]
[[sv:Mall:Str len]]
[[th:แม่แบบ:Str len]]
[[tr:Şablon:Str len]]
[[tt:Калып:Str len]]
[[uk:Шаблон:Str len]]
[[uz:Andoza:Str len]]
[[zh:Template:Str len]]
</includeonly>