eraseBetween

Delete substring between start and end points in Stateflow chart

Since R2021b

Syntax

newStr = eraseBetween(str,startStr,endStr)

newStr = eraseBetween(str,startPos,endPos)

newStr = eraseBetween(___,Boundaries=bounds)

Description

newStr = eraseBetween(str,startStr,endStr) deletes the substring in str between the substrings startStr and endStr. eraseBetween does not delete startStr and endStr themselves.

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

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

Note

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

Examples

Erase Text Between Substrings

Delete a substring to form the string "Hello!". By default, eraseBetween does not delete the boundary substrings.

str = "Hello, world!";
newStr = eraseBetween(str,"Hello","!");

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

str = "Hello, world!";
newStr = eraseBetween(str,",","d",new,Boundaries="inclusive");

Erase Text Between Start and End Positions

Delete a substring to form the string "Hello!". By default, eraseBetween deletes the boundary characters.

str = "Hello, world!";
newStr = eraseBetween(str,6,12);

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

str = "Hello, world!";
newStr = eraseBetween(str,5,13,new,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.

endStr — Ending substring

string scalar

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

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.

bounds — Boundary type

"inclusive" | "exclusive"

Boundary type, specified as either "inclusive" or "exclusive". When you set bounds to "inclusive", replaceBetween erases the text between and including the boundaries. When you set bounds to "exclusive", replaceBetween erases the text only between the boundaries.

Limitations

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

Version History

Introduced in R2021b