模板:Str find

此模板被引用于约723,000个页面，占全部页面的15%。
为了避免造成大规模的影响，所有对此模板的编辑应先于沙盒、测试样例或您的沙盒上测试。
测试后无误的版本可以一次性地加入此模板中，但是修改前请务必于讨论页发起讨论。

模板引用数量会自动更新。

此模板使用Lua语言：

用法[编辑]

{{str find|text|sub_string}} = 在字串text中搜寻并返回特定字串sub_string的位置。

Only searches first 50 characters of text. Returns -1 if sub_string not found in first 50 characters.
Character position is 1 based (not 0 based as usual in calculations

字符串处理模板

根据数量处理

{{str mid}}	按位置及长度选取子串。
{{trunc}}	切短到规定的字数。
{{str left}}	切短或重复填充到规定的字数。
{{str crop}}	从末尾切短特定数量的字元。
{{chop head and tail}}	To crop a specified number of characters off the beginning and end.

{{str right}}	返回从左向右移除若干个字符后的字符串
{{str rightc}}	返回从后向前指定数量的字符串，如果字符串为空则返回一个参数
{{str sub old}}	To trim down to a specified number, starting at a given number from the left.
{{str sub new}}	Select a substr based on starting and ending index.
{{str index}}	返回字符串的第×个字符

根据条件处理

{{trim}}	移除首尾空格。
{{str letter/trim}}	To trim down to the beginning letters.
{{str number/trim}}	To trim down to the beginning numbers.
{{trim brackets}}	To trim any leading or trailing square brackets.
{{trim quotes}}	To trim leading or trailing matches quotes.

专用于Wiki语法

{{WikiProjectbasename}}	Removes "WikiProject" from a pagename.
{{remove unranked}}	Removes the string "unranked_" from the left of a string (taxonomy).
{{ship prefix}}	Returns the length of a ship's name prefix, if listed (ship names).
{{title year}}	Returns the 4-digit year from a pagename, if any.

插入、替换、长度

{{strloc insert}}	Inserts a string at character location strloc, or appends if strloc<=0.
{{loop}}	特定次数重复字串。
{{replace}}	在字串中查找并全部替换某字串后返回。
{{str rep}}	在字串中查找并替换首次出现的某字串后返回。
{{digits}}	移除字串中不是数字（0～9）的字元。

{{str len}}	返回字串长度。
{{str ≥ len}}	检查一个字串和某一给定长度相比是“更长或等长”还是“更短”。
{{str ≤ len}}	检查一个字串和某一给定长度相比是“更短或等长”还是“更长”。
{{str ≠ len}}	检查一个字串和某一给定长度相比是“不等长”还是“等长”。
{{str ≤ ≥ len}}	检查一个字串和某一给定长度相比是“更短”、“等长”还是“更长”。

分析、技术

{{str endswith}}	检查是否以给定的字符串结尾。
{{str find}} {{strfind short}}	在一个字串中搜寻并返回特定字串的位置。
{{str find0}}	Zero-based substring search.
{{str sub find}}	从指定的偏移量开始搜索一个子字符串。
{{str letter}}	返回一个字符串开头的所有字符。
{{str number}}	返回一个字符串开头的所有数字。
{{str gtr str}}	判断两个字符串是否相等，然后根据返回相应的值。
{{str match}}	在一个字串中对正则表达式的查询结果进行分捕获组的输出。

{{ASCII code}}	返回单个字符的ASCII码值
{{a or an}}	Takes a noun and produces the appropriate indefinite article, based on whether the first letter is a vowel.

Module:String
...Magic words	About `{{padleft:\|}}`.
...ParserFunctions	About `{{#titleparts:\|}}, {{#expr:\|}}, {{#ifeq:\|}},` etc.

上述文档嵌入自Template:Str find/doc。
编者可以在本模板的沙盒和测试样例页面进行实验。
请在/doc子页面中添加分类。本模板的子页面。