https://arolstar52-zhtest.hf.space/index.php?action=history&feed=atom&title=Template%3AString_split%2FdocTemplate:String split/doc - 版本历史2026-06-26T14:10:17Z在这个wiki上该页的修订历史MediaWiki 1.43.8https://arolstar52-zhtest.hf.space/index.php?title=Template:String_split/doc&diff=3712905&oldid=previmported>Jimmy-bot：机器人: 尚未清空的已重定向分类） （Cat:String_manipulation_templates→Cat:字符串處理模板2025-01-02T10:21:10Z<p>机器人: 尚未清空的已重定向分类） （<a href="/index.php?title=Cat:String_manipulation_templates&action=edit&redlink=1" class="new" title="Cat:String manipulation templates（页面不存在）">Cat:String_manipulation_templates</a>→<a href="/index.php?title=Cat:%E5%AD%97%E7%AC%A6%E4%B8%B2%E8%99%95%E7%90%86%E6%A8%A1%E6%9D%BF&action=edit&redlink=1" class="new" title="Cat:字符串處理模板（页面不存在）">Cat:字符串處理模板</a></p>
<p><b>新页面</b></p><div>{{Documentation subpage}}<br />
{{Lua|Module:String2}}<br />
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) --><br />
[[Template:String split]] is a convenience wrapper for the <code>split</code> function in [[Module:String2]].<br />
<br />
The <code>split</code> function splits text at boundaries specified by separator and returns the chunk for the index idx (starting at 1). It can use positional parameters or named parameters (but these should not be mixed):<br />
* <code><nowiki>{{#invoke:String2 |split |text |separator |index |true/false}}</nowiki></code><br />
* <code><nowiki>{{#invoke:String2 |split |txt=text |sep=separator |idx=index |plain=true/false}}</nowiki></code><br />
Any double quotes (") in the separator parameter are stripped out, which allows spaces and wikitext like <code><nowiki>["[</nowiki></code> to be passed. Use <code>{{tl|!}}</code> for the pipe character <code>|</code>.<br />
<br />
If the optional plain parameter is set to <code>false / no / 0</code> then separator is treated as a Lua pattern. The default is plain=true, i.e. normal text matching.<br />
<br />
The index parameter is optional; it defaults to the first chunk of text. A negative parameter value counts chunks backward from the end of the text.<br />
<br />
== Examples ==<br />
<br />
* <code><nowiki>{{String split |This is a piece of text to be split |" "}}</nowiki></code> → {{String split |This is a piece of text to be split |" "}}<br />
* <code><nowiki>{{String split |This is a piece of text to be split |" "| 4}}</nowiki></code> → {{String split |This is a piece of text to be split |" "| 4}}<br />
* <code><nowiki>{{String split |This is a piece of text to be split |x| 2}}</nowiki></code> → {{String split |This is a piece of text to be split |x| 2}}<br />
Modules may return strings with | as separators like this: <code><nowiki>{{#invoke:carousel | main | name = WPDogs | switchsecs = 5 }}</nowiki></code> → {{#invoke:carousel | main | name = WPDogs | switchsecs = 5 }}<br />
* <code><nowiki>{{String split |{{#invoke:carousel | main | name = WPDogs | switchsecs = 5 }}|{{!}}| 2}}</nowiki></code> → {{String split |{{#invoke:carousel | main | name = WPDogs | switchsecs = 5 }}|{{!}}| 2}}<br />
Lua patterns can allow splitting at classes of characters such as punctuation:<br />
* <code><nowiki>{{String split |Apples, pears, oranges; Cats, dogs|"%p"| 2 |false}}</nowiki></code> → {{String split |Apples, pears, oranges; Cats, dogs|"%p"| 2 |false}}<br />
* <code><nowiki>{{String split |Apples, pears, oranges; Cats, dogs|"%p"| 4 |false}}</nowiki></code> → {{String split |Apples, pears, oranges; Cats, dogs|"%p"| 4 |false}}<br />
Or split on anything that isn't a letter (no is treated as false):<br />
* <code><nowiki>{{String split |Apples pears oranges; Cats dogs|"%A+"| 4 |no}}</nowiki></code> → {{String split |Apples pears oranges; Cats dogs|"%A+"| 4 |no}}<br />
Named parameters force the trimming of leading and trailing spaces in the parameters and are generally clearer when used:<br />
* <code><nowiki>{{String split | txt=Apples pears oranges; Cats dogs | sep="%A+" | idx=3 | plain=false }}</nowiki></code> → {{String split | txt=Apples pears oranges; Cats dogs | sep="%A+" | idx=3 | plain=false }}<br />
A negative index will count back from the end of the text:<br />
* <code><nowiki>{{String split |txt=This is a piece of text to be split |sep=" " |idx=-1}}</nowiki></code> → {{String split |txt=This is a piece of text to be split |sep=" " |idx=-1}}<br />
An easy mistake to make when using negative parameters is to forget that a trailing space in the text when passed as an unnamed parameter will induce an empty last chunk:<br />
* <code><nowiki>{{String split |This is a piece of text to be split |" "|-1}}</nowiki></code> → {{String split |This is a piece of text to be split |" "|-1}}<br />
* <code><nowiki>{{String split |This is a piece of text to be split|" "|-1}}</nowiki></code> → {{String split |This is a piece of text to be split|" "|-1}}<br />
<br />
==See also==<br />
{{String-handling templates}}<br />
<br />
<includeonly>{{sandbox other||<br />
<!-- Categories below this line, please; interwikis at Wikidata --><br />
[[Category:字符串處理模板]]<br />
}}</includeonly></div>imported>Jimmy-bot