`extract`

Extrai as partes de um texto que casam com um padrão ou string literal.

Categoria: Language Fundamentals > Data Types

Sintaxe

newStr = extract(str, pat)

Retorna toda ocorrência de pat encontrada em str.

Descrição

extract faz uma busca por padrão e retorna o texto casado em vez de posições. É uma alternativa prática a regexp(str, expr, 'match') quando um objeto pattern descreve o que se quer.

O resultado é sempre um string array, mesmo quando str é um vetor de caracteres.

Argumentos de entrada

str: String array, vetor de caracteres ou cell array de vetores de caracteres.
pat: Texto a procurar, ou um objeto pattern como digitsPattern ou lettersPattern.

Argumentos de saída

newStr: String array com um elemento por ocorrência, em ordem. Para várias strings de entrada, as ocorrências são reunidas em uma coluna.

Exemplo

Números dentro de um texto

extract("a1b22c333", digitsPattern)
extract("Item 12 and 34", digitsPattern)

Saída

ans = 3×1 string array

    "1"
    "22"
    "333"
ans = 2×1 string array

    "12"
    "34"

Veja também

extractBetween extractAfter extractBefore regexp digitsPattern strfind