# replace-替换匹配单元格的值
调用函数replace在区域内查找替换符合条件的内容。
最小支持版本：5.6.0
# 接口说明
已获取当前excelRange实例, 详情请见getRange (opens new window)。
# 语法
<ExcelRange object>.replace(<what>, <replacement>, 2, 1, false, false, false, false)
1
<ExcelRange object>.替换匹配单元格的值(<what>, <replacement>, 2, 1, false, false, false, false)
1
# 函数类型
实例函数
# 请求参数
| 参数名称 | 类型 | 是否必选 | 默认值 | 示例值 | 描述 |
|---|---|---|---|---|---|
| what | Cube.Object | 是 | 无 | "123" | 需被替换的内容。 |
| replacement | Cube.Object | 是 | 无 | "321" | 替换的内容。 |
| lookAt | Cube.Lang.Number | 是 | 2 | 1 | 查找方式。 2: 部分匹配 1: 全部匹配 |
| searchOrder | Cube.Lang.Number | 是 | 1 | 2 | 查找顺序。 2: 按列 1: 按行 |
| matchCase | Cube.Lang.Boolean | 是 | true | true | 是否区分大小写。取值： true: 区分大小写 false: 不 区分大小写 |
| matchByte | Cube.Lang.Boolean | 是 | true | true | 是否严格匹配双字节编码字符, 是否区分全/半角。取值： true: 区分全/半角 false: 不区分全/半角。 |
| searchFormat | Cube.Lang.Boolean | 是 | true | true | 是否使用Excel应用的FindFormat设置。取值： true: 使用FindFormat设置 false: 不使用FindFormat设置 |
| replaceFormat | Cube.Lang.Boolean | 是 | true | true | 是否使用Excel应用的ReplaceFormat设置。取值： true: 使用ReplaceFormat设置 false: 不使用ReplaceFormat设置 |
# 返回参数
| 参数名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| Result | Cube.Lang.Null | 无 | 该函数返回值为空值。 |
# 请求示例
excelRange.replace("123", "321", 1, 2, true, true, true, true)
1
最近更新时间: {
"value": "2023-09-12",
"effect": true
}