模板:Str len/doc

此页面是Template:Str len的模板文档。
此页面可能包含了模板的使用说明、分类和其他内容。

此模板文档被引用于约50,000个页面。
为了避免造成大规模的影响，所有对此模板文档的编辑应先于沙盒、测试样例或您的沙盒上测试。
测试后无误的版本可以一次性地加入此模板文档中，但是修改前请务必于讨论页发起讨论。

模板引用数量会自动更新。

这是{{str len}}巨型模板。

它取一字符串作为参数，并传回它的长度（不包括开端及末端的空白字符）。它能数算到最多500，若字符串长过500则传回500。

注意：大多数情况下，使用{{str ≥ len}}或其姊妹模板会更容易和占用更少服务器资源。请参阅以下的参见章节。

假如参数是空白或未定义，它会视它的长度为0：

{{str len}} 传回 0

{{str len|}} 传回 0

{{str len| }} 传回 0

即使字串包含空白字符、像一个数字或包含特别字符，它都能正确地数算长度：

{{str len| ab cde }} 传回 6

{{str len| 1234567 }} 传回 7

{{str len| café åäö }} 传回 8

{{str len| 字串包含空白字符、像一個數字或包含特別字符 }} 传回 21

{{str len| 499個字符... }} 传回 499

{{str len| 1000個字符... }} 传回 1000

MediaWiki没有解析器函数或魔术字来量度字串的长度。而使用模板来量度对服务器来说是非常吃力的，因此这模板已经尽量优化。但是你应该考虑使用{{str ≥ len}}，因在大多数情况下，使用该模板会更容易和占用更少服务器资源。

这模板呼叫{{str len/core}}来完成绝大部分工作。如要了解内部原理请参考/core。