replaceFirst
本节介绍 Zoho Creator 中的 replaceFirst 函数的语法和使用。
描述
replaceFirst 函数使用给定的 <replacementString> 替换第一次出现的匹配给定 <searchString> 的字符串。
语法
<string>.replaceFirst(searchString, replacementString, [escapeRegEx])
(或)
replaceFirst(string, searchString, replacementString, [escapeRegEx]
// 仅在脚本构建器的自由流程脚本模式下才支持此格式。
// 仅在脚本构建器的自由流程脚本模式下才支持此格式。
replaceFirst 函数语法有以下参数。
string - 必需。主字符串
searchString - 必需。要在主字符串内搜索的子字符串
replacementString - 必需。替换子字符串
默认情况下, replaceFirst() 函数支持常规表达式,即它将不会查找和替换源字符串中的 $、* 等特殊字符。参数 [escapeRegEx] 是可选布尔值参数,用于指定 Zoho Creator 在执行 replaceAll() 函数时是支持还是忽略正则表达式。
- true 值表示忽略替换函数的正则表达式支持。
- false 值表示支持替换函数的正则表达式。默认情况下,值为“false”。
注:如果未指定 escapeRegEx 参数的值,则我们将值视为“false”。
返回值
返回被替换字符串。
示例
replaceFirst("abcabcabc", "ab", "x"); //返回 xcabcabc
"abcabcabc".replaceFirst( "ab", "x"); //返回 xcabcabc