模板: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。