编辑“︁模块:String/doc”︁（章节）

== find ==

此函数在一个字符串内搜索另一个字符串。

用法：

: <code><nowiki>{{#invoke:</nowiki>String|find-{}-|''源字符串''|''目标字符串''|''开始索引''|''纯标记''}}</code>

或

: <code><nowiki>{{#invoke:</nowiki>String|find|-{}-source= ''源字符串'' |target= ''目标字符串'' |start= ''开始索引'' |plain= ''纯标记'' }}</code>

参数：

; source
: 在此字符串内搜索
; target
: 在源字符串内搜索的字符串
; start
: 在源字符串的此位置索引版主开始搜索。默认为1
; plain
: 布尔值标记，表示目的应该被理解为纯文本，而不是[[mw:Special:MyLanguage/Extension:Scribunto/Lua reference manual#Ustring patterns|Scribunto ustring模式]]，默认为true

此函数返回了在索引&gt;"start"，其中"source"中可以持续到"target"。索引是从1开始数的。如果没有找到目标字符串，函数返回0。如果索引或者目的缺失或者是空的，此函数也会返回0。

此函数应该可以安全地操作UTF-8字符串。

示例：
* <code><nowiki>{{#invoke:String|find|abc123def|12}}</nowiki></code> → {{#invoke:String|find|abc123def|12}}
* <code><nowiki>{{#invoke:String|find|source=abc123def|target=12}}</nowiki></code> → {{#invoke:String|find|source=abc123def|target=12}}
* <code><nowiki>{{#invoke:String|find|source=abc123def|target=pqr}}</nowiki></code> → {{#invoke:String|find|source=abc123def|target=pqr}}
* <code><nowiki>{{#invoke:String|find| abc123def |123}}</nowiki></code> → {{#invoke:String|find| abc123def |123}}
* <code><nowiki>{{#invoke:String|find|source= abc123def |target= 123 }}</nowiki></code> → {{#invoke:String|find|source= abc123def |target= 123 }}
* <code><nowiki>{{#invoke:String|find|source=abc123def|target=%d |start=3 |plain=false }}</nowiki></code> → {{#invoke:String|find|source=abc123def|target=%d |start=3 |plain=false }}

与未命名的参数使用时，两端的空格会被保留且被计入：
* <code><nowiki>{{#invoke:String|find|  abc123def |c|false}}</nowiki></code> → {{#invoke:String|find|  abc123def |c|false}}
* <code><nowiki>{{#invoke:String|find|source=  abc123def |target=c|plain=false}}</nowiki></code> → {{#invoke:String|find|source=  abc123def |target=c|plain=false}}
* <code><nowiki>{{#invoke:string|find|abc 123 def|%s|plain=false}}</nowiki></code> → {{#invoke:string|find|abc 123 def|%s|plain=false}}

检测字符串是否存在：
* <code><nowiki>{{#ifexpr:{{#invoke:string|find|haystack|needle}}|Found needle|Didn't find needle}}</nowiki></code> → Didn't find needle