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

== str_find ==

此函数与<nowiki>{{Str sub old}}</nowiki>的行为重复，包含了其所有的技巧，仅为支持存在的模板，但是对于新的代码和模板''不推荐''使用。新的代码建议直接使用find函数。

返回源字符串中匹配目的的第一个索引。索引是从1开始数的，如果源字符串中找不到目标字符串，则返回-1。

注意：如果目标字符串是空白或者缺失，则函数返回值为1，这可能不是预期的行为，必须要单独考虑。

用法：

: <code><nowiki>{{#invoke:</nowiki>String|str_find|-{}-''源字符串''|''目标字符串''}}</code>

或

: <code><nowiki>{{#invoke:</nowiki>String|str_find|source= ''源字符串'' |target= ''目标字符串'' }}</code>

参数：

; source
: 在此字符串内搜索
; target
: 在源内搜索的字符串

示例：
* <code><nowiki>{{#invoke:String|str_find| abc123def }}</nowiki></code> → {{#invoke:String|str_find| abc123def }}
* <code><nowiki>{{#invoke:String|str_find|source= abc123def }}</nowiki></code> → {{#invoke:String|str_find|source= abc123def }}
* <code><nowiki>{{#invoke:String|str_find| abc123def |123}}</nowiki></code> → {{#invoke:String|str_find| abc123def |123}}
* <code><nowiki>{{#invoke:String|str_find|source= abc123def |target= 123 }}</nowiki></code> → {{#invoke:String|str_find|source= abc123def |target= 123 }}
* <code><nowiki>{{#invoke:String|str_find| abc123def |not}}</nowiki></code> → {{#invoke:String|str_find| abc123def |not}}