replace

Find and replace substrings in string array

collapse all in page

Syntax

  • newStr = replace(str,old,new)
    example

Description

example

newStr = replace(str,old,new) replaces all occurrences of old in string array str with new. If old contains multiple substrings, then new either must be the same size as old, or must be a single substring.

Examples

collapse all

Open Script

Replace placeholder text in a list of file names.

str = string({'<ROOT_DIR>\MyData\data.tar.gz';...
              '<ROOT_DIR>\MyScripts\cleandata.m';...
              '<ROOT_DIR>\MyScripts\preprocess.m';...
              '<ROOT_DIR>\MyScripts\publishResults.m'})

str = 

  4×1 string array

    "<ROOT_DIR>\MyData\data.tar.gz"
    "<ROOT_DIR>\MyScripts\cleandata.m"
    "<ROOT_DIR>\MyScripts\preprocess.m"
    "<ROOT_DIR>\MyScripts\publishResults.m"


old = '<ROOT_DIR>';
new = 'C:\MyProject';
newStr = replace(str,old,new)

newStr = 

  4×1 string array

    "C:\MyProject\MyData\data.tar.gz"
    "C:\MyProject\MyScripts\cleandata.m"
    "C:\MyProject\MyScripts\preprocess.m"
    "C:\MyProject\MyScripts\publishResults.m"
Open Script

Replace carriage returns with newline characters.

str = string({'Submission Date: 11/29/15\r';
              'Acceptance Date: 1/20/16\r';
              'Contact: john.smith@example.com\r\n'})

str = 

  3×1 string array

    "Submission Date: 11/29/15\r"
    "Acceptance Date: 1/20/16\r"
    "Contact: john.smith@example.com\r\n"


old = {'\r\n','\r'};
new = '\n';
newStr = replace(str,old,new)

newStr = 

  3×1 string array

    "Submission Date: 11/29/15\n"
    "Acceptance Date: 1/20/16\n"
    "Contact: john.smith@example.com\n"

Related Examples

Input Arguments

collapse all

Input text, specified as a string array, a character vector, or a cell array of character vectors.

Data Types: string | char | cell

Substring to replace, specified as a string array, character vector, or cell array of character vectors.

Data Types: string | char | cell

New substring, specified as a string array, character vector, or cell array of character vectors.

Data Types: string | char | cell

More About

collapse all

Tall Array Support

This function fully supports tall arrays. For more information, see Tall Arrays.

Tips

  • To perform multiple replacements for overlapping patterns, use the strrep function.

See Also

| | | | | | | | | | | | | | | |

Introduced in R2016b

Was this topic helpful?
MATLAB Documentation
Other Documentation
Support