`regexprep`

Substitui o texto que casa com uma expressão regular.

Categoria: Language Fundamentals > Data Types

Sintaxe

newStr = regexprep(str, expr, repl)

Substitui toda ocorrência de expr em str por repl.

newStr = regexprep(___, option)

Opções como 'once' (só a primeira ocorrência) e 'ignorecase'.

Descrição

A substituição é feita em uma única passada da esquerda para a direita, então o texto inserido não é pesquisado de novo. Referências a grupos permitem reorganizar texto: substituir (\w+) (\w+) por $2 $1 troca duas palavras.

O resultado mantém o tipo da entrada: char gera char, string gera string e cell array gera cell array.

Argumentos de entrada

str: Vetor de caracteres, string, ou cell array deles.
expr: Expressão regular, ou cell array de expressões aplicadas em ordem.
repl: Texto de substituição. $1, $2, ... inserem o texto capturado por cada grupo; $0 insere a ocorrência inteira.

Argumentos de saída

newStr: Mesmo tipo de str, com as substituições feitas.

Exemplo

regexprep('hello world', '(\w+) (\w+)', '$2 $1')
regexprep('abc', 'B', 'x', 'ignorecase')
regexprep('a  b   c', '\s+', ' ')
regexprep('aaa', 'a', 'b', 'once')

Saída

ans = 'world hello'
ans = 'axc'
ans = 'a b c'
ans = 'baa'

Veja também

regexp regexpi strrep replace regexptranslate