View source for Template:Strfind short/doc

{{Documentation subpage}}
{{Wikipedia text|Template:Strfind short/doc|415372995}}

The '''[[Template:Strfind_short]]''' finds the location, in parameter {1} with length lenstr=15 (up to 99), of the string {2} with length {3}, using a simple, quick method. If the string is not found, the result is zero (0), indicating no match. The parameter lenstr can be shorter than the actual 1st string, to stop the search earlier (and faster). The template was designed to use only 5 levels of expansion depth, rather than 18 or more levels as in other string-searching templates.

:'''Usage:''' &nbsp;{&#123;'''strfind short'''|abcdef|bcd|3}} {{in5}} &rarr; {{str_find|abcdef|bcd|3}}
::: {&#123;'''strfind short'''|123456789.|45|2}} &rarr; {{strfind short|123456789.|45|2}}
::: {&#123;'''strfind short'''|x+2.437-6|2.43|4}} &rarr; {{strfind short|x+2.437-6|2.43|4}}
::: {&#123;'''strfind short'''|:***abcd**|*ab| {&#123;strlen_short|*ab}} }} &rarr; {{strfind short|:***abcd**|*ab| {{strlen_short|*ab}} }}

If the length of the substring {2} is not known, or changes often, then the extra template {strlen_quick} can be used as: {&#123;strlen_quick|{&#123;{2}}}&nbsp;}}, to determine the length of string 2, quickly.

==Examples==
The following are examples:
:* {&#123;strfind short|abcdef|bcd|3}} {{in5}} &rarr; {{strfind_short|abcdef|bcd|3}}
:* {&#123;strfind short|Fast Forward (film)|(|1}} {{in5}} &rarr; {{strfind_short|Fast Forward (film)|(|1}}
:* {&#123;strfind short|Fast Forward Longer (film)|(|1}} &rarr; {{strfind_short|Fast Forward Longer (film)|(|1}}
:* {&#123;strfind short|Fast Forward Longer (film)|(|1|lenstr=26}} &rarr; {{strfind_short|Fast Forward Longer (film)|(|1|lenstr=26}}

:* {&#123;strfind short|A Funny Thing Happened on the Way to the Forum (film)|(|1|lenstr=53}} &rarr; {{strfind_short|A Funny Thing Happened on the Way to the Forum (film)|(|1|lenstr=53}}

==Performance impact==
The operation of Template:Strfind_short was designed to run 4x times faster than other string-search templates; however, it typically runs 20x times faster (or shorter) for strings up to 15 characters long. The post-expand include size averages about 300 bytes (rather than 6,000 bytes for other string-search templates). It can be used over 5,000 times per page (compared to only 350 times for other search templates). For strings over 50 long, it will use more resources, due to processing strings larger than other templates had allowed.

==See also==
* {{tl|Str find}} - searches strings, but with expansion depth of 18 or more

{{String templates see also}}

[[Category:Templates with minimal expansion depth]]
[[Category:Wikipedia formatting and function templates]]