Template:Str find: Difference between revisions

VisualWikitext

Latest revision as of 23:35, 28 October 2019

1

Template documentation[ view · edit · history · purge ]

This documentation is transcluded from Template:Str find/doc.

Uses Lua:

Module:String

Usage: Returns the position (1 for the first character) of first appearance of substring in a text, -1 if not found.; Note: if you want to edit this template, first try your modifications on {{Str find/sandbox}}.You can then test your edits in {{Str find/testcases}}.
When the new version is ready, you can move it to the main template.

Examples

{{Str find|Panthera (genus)|P}} → 1 (first character)
{{Str find|Panthera (genus)|a}} → 2 (second character)
{{Str find|Panthera (genus)|(}} → 10
{{Str find|Panthera (genus)|/}} → -1 (means not found)
{{Str find|Panthera (genus)|}} → 1 (Warning: empty substring returns 1)

Syntax

{{Str find | <text> | <substring> }}

Parameters

<text>

the tested string

<substring>

the substring to be searched in the <text>

if <substring> is empty, this template returns 1

you cannot search for = as it is interpreted as a parameter separator

See also

{{Str find/logic}} a subtemplate

Trimming templates:

{{Trunc}} – To trim down to a specified number of characters.
{{Trim}} — To trim any leading or trailing whitespace.
{{Str left}} – To trim down to a specified number of characters, or duplicate the string to a specified number.
{{Str right}}
{{Strip}} – To strip (remove) a given number of characters from the beginning/end of the string

Analyzing templates:

{{Str endswith}} – To check if a string ends with a given string.
{{Str find}} – Returns the numerical location of a given string in a string, up to 50 characters.
{{Str len}} – Returns a string's length. Can count up to 500 characters.

String length comparison templates:

{{Str ≤ len}} – To check if a string is "shorter or equally long" or "longer" than a given length.

Sandboxes and test cases:

Technical stuff:

mw:Help:Magic words – About {{padleft:|}}.
mw:Help:Extension:ParserFunctions – About {{#titleparts:|}}, {{#expr:|}}, {{#ifeq:|}}, etc.
Module:String - Script with native string parsing

@@ Line 1: / Line 1: @@
-{{#swtitch:*{{{2|}}}*
+{{#invoke:String|str_find|source={{{1|}}}|{{{2|}}}}}<noinclude>
-|**=-1
-|*{{str_index|{{{1|}}}|1}}*=1
+{{documentation}}
-|*{{str_index|{{{1|}}}|2}}*=2
-|*{{str_index|{{{1|}}}|3}}*=3
+</noinclude>
-|*{{str_index|{{{1|}}}|4}}*=4
-|*{{str_index|{{{1|}}}|5}}*=5
-|*{{str_index|{{{1|}}}|6}}*=6
-|*{{str_index|{{{1|}}}|7}}*=7
-|*{{str_index|{{{1|}}}|8}}*=8
-|*{{str_index|{{{1|}}}|9}}*=9
-|*{{str_index|{{{1|}}}|10}}*=10
-|*{{str_index|{{{1|}}}|11}}*=11
-|*{{str_index|{{{1|}}}|12}}*=12
-|*{{str_index|{{{1|}}}|13}}*=13
-|*{{str_index|{{{1|}}}|14}}*=14
-|*{{str_index|{{{1|}}}|15}}*=15
-|*{{str_index|{{{1|}}}|16}}*=16
-|*{{str_index|{{{1|}}}|17}}*=17
-|*{{str_index|{{{1|}}}|18}}*=18
-|*{{str_index|{{{1|}}}|19}}*=19
-|*{{str_index|{{{1|}}}|20}}*=20
-|*{{str_index|{{{1|}}}|21}}*=21
-|*{{str_index|{{{1|}}}|22}}*=22
-|*{{str_index|{{{1|}}}|23}}*=23
-|*{{str_index|{{{1|}}}|24}}*=24
-|*{{str_index|{{{1|}}}|25}}*=25
-|*{{str_index|{{{1|}}}|26}}*=26
-|*{{str_index|{{{1|}}}|27}}*=27
-|*{{str_index|{{{1|}}}|28}}*=28
-|*{{str_index|{{{1|}}}|29}}*=29
-|*{{str_index|{{{1|}}}|30}}*=30
-|*{{str_index|{{{1|}}}|31}}*=31
-|*{{str_index|{{{1|}}}|32}}*=32
-|*{{str_index|{{{1|}}}|33}}*=33
-|*{{str_index|{{{1|}}}|34}}*=34
-|*{{str_index|{{{1|}}}|35}}*=35
-|*{{str_index|{{{1|}}}|36}}*=36
-|*{{str_index|{{{1|}}}|37}}*=37
-|*{{str_index|{{{1|}}}|38}}*=38
-|*{{str_index|{{{1|}}}|39}}*=39
-|*{{str_index|{{{1|}}}|40}}*=40
-|*{{str_index|{{{1|}}}|41}}*=41
-|*{{str_index|{{{1|}}}|42}}*=42
-|*{{str_index|{{{1|}}}|43}}*=43
-|*{{str_index|{{{1|}}}|44}}*=44
-|*{{str_index|{{{1|}}}|45}}*=45
-|*{{str_index|{{{1|}}}|46}}*=46
-|*{{str_index|{{{1|}}}|47}}*=47
-|*{{str_index|{{{1|}}}|48}}*=48
-|*{{str_index|{{{1|}}}|49}}*=49
-|*{{str_index|{{{1|}}}|50}}*=50
-|-1
-}}

commons>Snævar

Latest revision as of 23:35, 28 October 2019