Template:In string/doc
Appearance
This template is used on approximately 114,000 pages. To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them. |
This template can only be edited by administrators because it is transcluded onto one or more cascade-protected pages. |
This is a documentation subpage for Template:In string. It may contain usage information, categories and other content that is not part of the original template page. |
This template uses Lua: |
This template wraps the function {{#invoke:String|find|...}}
, and provides the extra option to return an alternative string (including a blank string) when nothing is found.
Usage
[edit]{{In string|source_string|target_string|start_index|plain_flag|nomatch_returntext}}
- or
{{In string|source=source_string |target=target_string |start=start_index |plain=plain_flag |nomatch=nomatch_returntext}}
{{In string |source= |target= |start= |plain= |nomatch= }}
- By default, when the target is not found,
0
is returned. - Set
|nomatch=anytext
to replace that0
. Also,|nomatch=
<blank> returns blank not 0.
- Note: outer spaces are not conserved.
- Using the nomatch option
- {{#if:{{in string|source=pancake|target=pizza|plain=true|nomatch=}}|Is a pizza|Not a pizza}} → Not a pizza
- {{#if:{{in string|source=Hawaiian pizza|target=pizza|plain=true|nomatch=}}|Is a pizza|Not a pizza}} → Is a pizza
Examples
[edit]{{In string|abc123def }}
→ 0{{In string|source= abc123def }}
→ 0{{In string|abc123def |123}}
→ 4{{In string|source= abc123def |target= 123 }}
→ 4{{In string|abc123def |%d|3|false}}
→ 4{{In string|source= abc123def |target= %d |start= 3 |plain= false }}
→ 4
- nomatch=xxx
{{In string|abc123def |nomatch=xxx}}
→ xxx{{In string|source= abc123def |nomatch=xxx}}
→ xxx{{In string|abc123def |123|nomatch=xxx}}
→ 4{{In string|source= abc123def |target= 123 |nomatch=xxx}}
→ 4{{In string|abc123def |%d|3|false|nomatch=xxx}}
→ 4{{In string|source= abc123def |target= %d |start= 3 |plain= false |nomatch=xxx}}
→ 4
- nomatch = blank
{{In string|abc123def |nomatch=}}
→{{In string|source= abc123def |nomatch=}}
→{{In string|abc123def |123|nomatch=}}
→ 4{{In string|source= abc123def |target= 123 |nomatch=}}
→ 4{{In string|abc123def |%d|3|false|nomatch=}}
→ 4{{In string|source= abc123def |target= %d |start= 3 |plain= false |nomatch=}}
→ 4
- module Examples
{{#invoke:String|find|abc123def }}
→ 0{{#invoke:String|find|source= abc123def }}
→ 0{{#invoke:String|find|abc123def |123}}
→ 4{{#invoke:String|find|source= abc123def |target= 123 }}
→ 4{{#invoke:String|find|abc123def |%d|3|false}}
→ 4{{#invoke:String|find|source= abc123def |target= %d |start= 3 |plain= false }}
→ 4
Template data
[edit]This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:In string in articles based on its TemplateData.
TemplateData for In string
Template data
| ||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
No description.
|