REPLACEB
Replaces a set of characters, based on the number of characters and the start position specified, with a new set of characters and is intended for languages that use the double-byte character set (DBCS) like Japanese, Chinese, Korean etc.
Syntax
expression.REPLACEB(arg1, arg2, arg3, arg4);
expression - A variable that represents a ApiWorksheetFunction class.
Parameters
| Name | Required/Optional | Data type | Default | Description |
|---|---|---|---|---|
| arg1 | Required | ApiRange | ApiName | string | The text where some characters will be replaced. | |
| arg2 | Required | ApiRange | ApiName | number | The position of the character in the original text that will be replaced with the new text. | |
| arg3 | Required | ApiRange | ApiName | number | The number of characters in the original text that will be replaced, based on bytes. | |
| arg4 | Required | ApiRange | ApiName | string | The text that will replace characters in the original text. |
Returns
string
Example
This example shows how to replace a set of characters, based on the number of characters and the start position specified, with a new set of characters and is intended for languages that use the double-byte character set (DBCS) like Japanese, Chinese, Korean etc.
- Code
- Result
// How to replace a substring with another one using starting index and length.
// Use a function to replace one part of a text with another one indicating charachters count and index.
let worksheet = Api.GetActiveSheet();
let func = Api.GetWorksheetFunction();
worksheet.GetRange("A1").SetValue(func.REPLACEB("Online Office", 8, 6, "portal"));