Bản mẫu:String split

Tài liệu bản mẫu[xem] [sửa] [lịch sử] [làm mới]

Template:Stringsplit is a convenience wrapper for the split function in Module:String2.

The split 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):

• {{#invoke:String2 |split |text |separator |index |true/false}}
• {{#invoke:String2 |split |txt=text |sep=separator |idx=index |plain=true/false}}

Any double quotes (") in the separator parameter are stripped out, which allows spaces and wikitext like ["[ to be passed. Use {{!}} for the pipe character |.

If the optional plain parameter is set to false / no / 0 then separator is treated as a Lua pattern. The default is plain=true, i.e. normal text matching.

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.

Examples

• {{Stringsplit |This is a piece of text to be split |" "}} → This
• {{Stringsplit |This is a piece of text to be split |" "| 4}} → piece
• {{Stringsplit |This is a piece of text to be split |x| 2}} → t to be split

Modules may return strings with | as separators like this: {{#invoke:carousel | main | name = WPDogs | switchsecs = 5 }} → Dobermann Fond Blanc.jpg | Female Dobermann with docked tail

• {{Stringsplit |{{#invoke:carousel | main | name = WPDogs | switchsecs = 5 }}|{{!}}| 2}} → Female Dobermann with docked tail

Lua patterns can allow splitting at classes of characters such as punctuation:

• {{Stringsplit |Apples, pears, oranges; Cats, dogs|"%p"| 2 |false}} → pears
• {{Stringsplit |Apples, pears, oranges; Cats, dogs|"%p"| 4 |false}} → Cats

Or split on anything that isn't a letter (no is treated as false):

• {{Stringsplit |Apples pears oranges; Cats dogs|"%A+"| 4 |no}} → Cats

Named parameters force the trimming of leading and trailing spaces in the parameters and are generally clearer when used:

• {{Stringsplit | txt=Apples pears oranges; Cats dogs | sep="%A+" | idx=3 | plain=false }} → oranges

A negative index will count back from the end of the text:

• {{Stringsplit |txt=This is a piece of text to be split |sep=" " |idx=-1}} → split

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:

• {{Stringsplit |This is a piece of text to be split |" "|-1}} →
• {{Stringsplit |This is a piece of text to be split|" "|-1}} → split

Tài liệu bên trên được truyền tải từ Bản mẫu:String split/doc. (sửa | lịch sử)
Biên tập viên sửa đổi có thể thử nghiệm trong các trang chỗ thử (tạo | sao) và trường hợp kiểm thử (tạo) của bản mẫu này.
Xin hãy bổ sung các thể loại vào trang con /doc. Các trang con của bản mẫu này.