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