Template:In string/doc

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:

Module:String

This template implements the :Module:String|find function ({{#invoke:String|find|...}}).

It has an extra option to return any text or <blank;> when not found.

Usage

{{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 that 0. 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

Examples

{{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