replaceBetween

Replace substrings between start and end points

Syntax

newStr = replaceBetween(str,startStr,endStr,new)

newStr = replaceBetween(str,startPos,endPos,new)

newStr = replaceBetween(___,Boundaries=bounds)

Description

newStr = replaceBetween(str,startStr,endStr,new) replaces the substring in str between the substrings startStr and endStr with the string new. replaceBetween does not replace startStr and endStr themselves. new can have a different number of characters than the substring it replaces.

newStr = replaceBetween(str,startPos,endPos,new) replaces the substring in str between the character positions startPos and endPos, including the characters at those positions.

newStr = replaceBetween(___,Boundaries=bounds) includes or excludes the boundaries specified in the previous syntaxes from the substring that the operator replaces. Specify bounds as "inclusive" or "exclusive".

Note

The replaceBetween operator is not supported in Stateflow^® charts that use C as the action language.

Examples

Replace Text Between Substrings

Replace a substring to form the string "Hello, Mars!". By default, replaceBetween does not replace the boundary substrings.

str = "Hello, world!";
newStr = replaceBetween(str,"Hello, ","!","Mars");

Alternatively, use the option Boundaries="inclusive" to replace the boundary substrings.

str = "Hello, world!";
newStr = replaceBetween(str,"w","d","Mars",Boundaries="inclusive");

Replace Text Between Start and End Positions

Replace a substring to form the string "Hello, Mars!". By default, replaceBetween replaces the boundary characters.

str = "Hello, world!";
newStr = replaceBetween(str,8,12,"Mars");

Alternatively, use the Boundaries="exclusive" option to prevent replacement of the boundary characters.

str = "Hello, world!";
newStr = replaceBetween(str,7,13,"Mars",Boundaries="exclusive");

Input Arguments

str — Input string

string scalar

Input string, specified as a string scalar. Enclose literal strings with double quotes.

Example: "Hello"

startStr — Starting substring

string scalar

Staring substring, specified as a string scalar. Enclose literal strings with double quotes.

Example: "Hello"

endStr — Ending substring

string scalar

Ending substring, specified as a string scalar. Enclose literal strings with double quotes.

Example: "Hello"

startPos — Starting character position

positive integer

Starting character position, specified as a positive integer.

endPos — Ending character position

positive integer

Ending character position, specified as a positive integer.

new — New substring

string scalar

New substring, specified as a string scalar. Enclose literal strings with double quotes.

Example: "Hello"

bounds — Boundary type

"inclusive" | "exclusive"

Boundary type, specified as "inclusive" or "exclusive". When you set bounds to "exclusive", replaceBetween replaces only the text between the boundaries. When you set bounds to "inclusive", replaceBetween also replaces the boundaries themselves.

Limitations

• This operator does not support the use of Stateflow structure fields. For more information about structures in Stateflow, see Access Bus Signals Through Stateflow Structures.

Version History

Introduced in R2021b