Template:Str len/doc: Difference between revisions
Template page
More actions
m moved Template:Str len full/doc to Template:Str len/doc: Moving this over {{str len}}, since that is the better name but this is the better code. Thus merging with {{str len}}. See talk page. |
Changed all references from {{str len full}} to {{str len}} due to move to that name. |
||
| Line 7: | Line 7: | ||
}} | }} | ||
This is the {{tl|str len | 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. | 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. | ||
| Line 17: | Line 17: | ||
If the parameter is empty or undefined it is considered to be of zero length: | If the parameter is empty or undefined it is considered to be of zero length: | ||
:<code><nowiki>{{str len | :<code><nowiki>{{str len}}</nowiki></code> returns {{str len}} | ||
:<code><nowiki>{{str len | :<code><nowiki>{{str len|}}</nowiki></code> returns {{str len|}} | ||
:<code><nowiki>{{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: | It counts the length correctly, even if the string contains spaces, looks like a number, or contains special characters: | ||
:<code><nowiki>{{str len | :<code><nowiki>{{str len| ab cde }}</nowiki></code> returns {{str len| ab cde }} | ||
:<code><nowiki>{{str len | :<code><nowiki>{{str len| 1234567 }}</nowiki></code> returns {{str len| 1234567 }} | ||
:<code><nowiki>{{str len | :<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: | It can measure strings up to 500 in length, and returns 500 for strings that are too long: | ||
:<code><nowiki>{{str len | :<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 | :<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 === | === Technical details === | ||
| Line 38: | Line 38: | ||
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. | 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 | 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 === | === See also === | ||
Revision as of 02:33, 30 March 2009
 | This template employs some extremely complicated or esoteric features of template syntax. Please do not attempt to alter it unless you are certain that you understand the setup and are prepared to repair/revert any consequent collateral damage if the results are unexpected. Any experiments should be conducted in a sandbox or your userspace. |
This is the {{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 {{Str ≥ len}} or one of its sister templates. See the see also section below.
Examples
If the parameter is empty or undefined it is considered to be of zero length:
{{str len}}returns 0{{str len|}}returns 0{{str len| }}returns 0
It counts the length correctly, even if the string contains spaces, looks like a number, or contains special characters:
{{str len| ab cde }}returns 6
{{str len| 1234567 }}returns 7
{{str len| café åäö }}returns 8
It can measure strings up to 500 in length, and returns 500 for strings that are too long:
{{str len| 499-characters... }}returns 499{{str len| 1000-characters... }}returns 1000
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 {{Str ≥ len}} instead, since for most usage cases it is much easier to use and it costs much less server resources.
This template calls {{Str len/core}} which does most of the work. For documentation on the internal workings of these two templates see /core. The talk page might also have more details.
See also
Trimming templates:
- {{Trunc}} – To trim down to a specified number of characters.
- {{Trim}} — To trim any leading or trailing whitespace.
- {{Str left}} – To trim down to a specified number of characters, or duplicate the string to a specified number.
- {{Str right}}
- {{Strip}} – To strip (remove) a given number of characters from the beginning/end of the string
Analyzing templates:
- {{Str endswith}} – To check if a string ends with a given string.
- {{Str find}} – Returns the numerical location of a given string in a string, up to 50 characters.
- {{Str len}} – Returns a string's length. Can count up to 500 characters.
String length comparison templates:
- {{Str ≤ len}} – To check if a string is "shorter or equally long" or "longer" than a given length.
Technical stuff:
- mw:Help:Magic words – About
{{padleft:|}}. - mw:Help:Extension:ParserFunctions – About
{{#titleparts:|}}, {{#expr:|}}, {{#ifeq:|}},etc. - Module:String - Script with native string parsing