`matches`

Testa se um texto casa inteiramente com um padrão.

Categoria: Language Fundamentals > Data Types

Sintaxe

tf = matches(str, pat)

Retorna true para cada elemento de str que é exatamente igual a pat, ou casado completamente por ele.

tf = matches(str, pat, IgnoreCase=true)

Ignora maiúsculas e minúsculas na comparação.

Descrição

Diferente de contains, que pede que o padrão apareça em qualquer parte do texto, matches exige que o texto inteiro seja casado. Assim matches('abc12', lettersPattern) é false por causa dos dígitos, enquanto contains seria true.

Argumentos de entrada

str: Array de strings, vetor de caracteres ou cell array de vetores de caracteres.
pat: Texto, array de textos ou objeto pattern. Se for um array, o resultado é true quando qualquer elemento casa.
IgnoreCase: Opção lógica; false por padrão.

Argumentos de saída

tf: Array lógico com um valor por elemento de str.

Exemplo

Casamento do texto inteiro

matches(["apple", "fig"], "fig")
matches('abc', lettersPattern)
matches('abc12', lettersPattern)
matches("Abc", "abc", IgnoreCase=true)

Saída

ans = 1×2 logical array

   0   1
ans = logical
   1
ans = logical
   0
ans = logical
   1

Veja também

contains startsWith endsWith strcmp pattern