replaceb_26r8() Function

Replaces a piece of the specified text with new text.

Parameters

replaceb_26r8( old_text, start_num, num_chars, new_text )

Keyword	Type	Description
old_text	Text	The original text before replacement.
start_num	Number	The positional index in bytes of the first byte of the substring to be replaced.
num_chars	Number	The length in bytes of the substring to be replaced.
new_text	Text	The text that will be inserted into the old text in place of the extricated substring.

Returns

Text

Using the function

The first byte of the entire text value is considered to have an index = 1.

Examples

The following example demonstrates the replaceb() function.

To experiment with examples, copy and paste the expression into an expression rule and click TEST RULE to see the output.

replaceb("oldtext",1,3,"new") returns newtext

New version details

A new version of the a!replaceb() function is available starting in Appian 26.9. The new version adds an encoding parameter that lets you specify a character encoding when performing byte-level text replacement. This is useful when working with multi-byte character sets such as UTF-8, Shift_JIS, or GBK.

If you are using replaceb_26r8(), it will continue to work as-is. To update to the new version, replace replaceb_26r8() with a!replaceb(). No other updates are needed.

Feature compatibility

The table below lists this function's compatibility with various features in Appian.

Feature	Compatibility	Note
Portals	Compatible
Offline Interfaces	Compatible
Sync-Time Custom Record Fields	Compatible	Can be used to create a custom record field that only evaluates at sync time.
Real-Time Custom Record Fields	Incompatible	Custom record fields that evaluate in real time must be configured using one or more Custom Field functions.
Process Reports	Compatible
Process Events	Compatible	Can be used to configure a process event node, such as a start event or timer event.
Process Autoscaling	Compatible	Can be used in autoscaled processes.
Event Consumer Filter Conditions	Compatible	Can be used in filter conditions.
Event Consumer Event Handlers	Compatible	Can be used in event handler expressions.

Feedback