View source for Template:Str len/doc

{{high-use}}
{{Documentation subpage}}
{{Lua|Module:String}}
<!----PLEASE ADD CATEGORIES WHERE INDICATED AT THE BOTTOM OF THIS PAGE----> 
This is the {{tl|str len}} meta-template.

It takes a string as parameter and returns its length (excluding spaces at the start and end). It can now count as high as necessary.

===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é åäö }}
:<code><nowiki>{{str len| </nowiki>{{tlp|loop|50|abcdefghij}}<nowiki> }}</nowiki></code> returns  {{str len| {{loop|50|abcdefghij}} }}
:<code><nowiki>{{str len| </nowiki>{{tlp|loop|10000|abcdefghij}}<nowiki> }}</nowiki></code> returns  {{str len| {{loop|10000|abcdefghij}} }}

===Template data===
{{TemplateDataHeader}}
<templatedata>
{
        "description": "The template takes a string as parameter and returns its length, excluding spaces at the start and end of the string",
        "params": {
                "1": {
                        "label": "Alpha-numeric text",
                        "description": "The string to be counted",
                        "type": "string",
                        "required": true
                }
        }
}
</templatedata>

===Technical details===
This is the first general-purpose template to be implemented using [[mw:Extension:Scribunto]]. The Lua code is located in [[Module:String]].

===See also===
{{String-handling templates |IRL}}

<includeonly>{{Sandbox other||

<!----CATEGORIES BELOW THIS LINE, PLEASE:---->
[[Category:String manipulation templates]]

}}</includeonly>