Main Content

replace

Find and replace substrings

Description

example

newStr = replace(str,old,new) replaces instances of the substring old that occur in the string str with the string new.

Note

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

Examples

expand all

Replace a substring to form the string "Hello, Mars!".

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

Stateflow chart that uses the replace operator in a state.

Input Arguments

expand all

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

Example: "Hello"

Substring to replace, specified as a string scalar. Enclose literal strings with double quotes.

Example: "Hello"

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

Example: "Hello"

Limitations

Algorithms

The replace operator replaces sequential substrings. For example, replace("abc 2 def 22 ghi 222 jkl 2222","22","*") returns "abc 2 def * ghi *2 jkl **". To replace overlapping substrings, use strrep. For more information, see Replace Repeated Pattern.

Version History

Introduced in R2021b