模組:String2/doc

这是Module:String2的文档页面

此模块文档被引用於約218,000個頁面，佔全部頁面的3%。
為了避免造成大規模的影響，所有對此模块文档的編輯應先於沙盒或測試樣例上測試。实施修改前，建议先在討論頁發起討論。

模板引用數量會自動更新。

此模块文档已评为beta版，可广泛使用。因其新近完成，请谨慎使用，以确保输出结果符合预期。

The module “String2” contains 4 available calls that convert strings to upper, lower, sentence or title case.

The sentence case function finds the first letter and capitalises that, so it works properly with text containing wiki-markup. Compare {{#invoke:String2|sentence|[[action game]]}} -> Action game with {{ucfirst:{{lc:[[action game]]}}}} -> action game. Piped wiki-links are handled as well: {{#invoke:String2|sentence|[[trimix (breathing gas)|trimix]]}} -> Trimix.

The title case function capitalises the first letter of each word in the text, apart from a number of short words recommended by The U.S. Government Printing Office Style Manual.

Further functions commonly used on strings would be useful additions.

用法

{#invoke:String2 | upper |…}}
{#invoke:String2 | lower |…}}
{#invoke:String2 | sentence |…}}
{#invoke:String2 | title |…}}

參數

Just one unnamed parameter is used, representing the text to be converted to the required case.

範例

Input	Output
{{#invoke:String2\| upper \| abcd }}	脚本错误：函数“upper”不存在。
{{#invoke:String2\| upper \| abCD }}	脚本错误：函数“upper”不存在。
{{#invoke:String2\| upper \| ABcd }}	脚本错误：函数“upper”不存在。
{{#invoke:String2\| upper \| ABCD }}	脚本错误：函数“upper”不存在。
{{#invoke:String2\| upper \| }}	脚本错误：函数“upper”不存在。

{{#invoke:String2\| lower \| abcd }}	脚本错误：函数“lower”不存在。
{{#invoke:String2\| lower \| abCD }}	脚本错误：函数“lower”不存在。
{{#invoke:String2\| lower \| ABcd }}	脚本错误：函数“lower”不存在。
{{#invoke:String2\| lower \| ABCD }}	脚本错误：函数“lower”不存在。
{{#invoke:String2\| lower \| }}	脚本错误：函数“lower”不存在。

{{#invoke:String2\| sentence \| abcd }}	Abcd
{{#invoke:String2\| sentence \| abCD }}	Abcd
{{#invoke:String2\| sentence \| ABcd }}	Abcd
{{#invoke:String2\| sentence \| ABCD }}	Abcd
{{#invoke:String2\| sentence \| [[action game]] }}	Action game
{{#invoke:String2\| sentence \| [[trimix (breathing gas)\|trimix]] }}	Trimix
{{#invoke:String2 \| sentence \| {{#invoke:WikidataIB \|getValue \|P136 \|name=genre \|fetchwikidata=ALL \|qid=Q1396889}} }}	影射小說、寓言
{{#invoke:String2\| sentence \| }}

{{#invoke:String2\| title \| abcd }}	Abcd
{{#invoke:String2\| title \| abCD }}	Abcd
{{#invoke:String2\| title \| ABcd }}	Abcd
{{#invoke:String2\| title \| ABCD }}	Abcd
{{#invoke:String2\| title \| }}
{{#invoke:String2\| title \| The Vitamins Are In My Fresh California Raisins}}	The Vitamins Are in My Fresh California Raisins

參見

Module:String for the following functions:

len
sub
sublength
match
pos
str_find
find
replace
rep