contains

Testa se um texto contém um dado trecho ou padrão.

Categoria: Language Fundamentals > Data Types

Sintaxe

tf = contains(str, pat)

tf = contains(str, pat, 'IgnoreCase', true)

Descrição

A busca é por texto simples, não por expressão regular. Quando pat é uma lista, um elemento de str conta como casamento se contiver qualquer item da lista. Para um único vetor de caracteres o resultado é escalar.

Use startsWith e endsWith para as pontas do texto, count para saber quantas vezes ocorre e regexp para expressões regulares.

Argumentos de entrada

str

Vetor de caracteres, array de strings ou cell array de vetores de caracteres.

pat

Texto, uma lista de textos (verdadeiro se qualquer um casar) ou um objeto pattern.

'IgnoreCase'

Lógico, padrão false.

Argumentos de saída

tf

Array lógico com o tamanho de str.

Exemplo

Strings, listas e caixa

contains("hello", 'ell')
contains({'apple','berry'}, 'AP', 'IgnoreCase', true)
contains("abc", ["x" "c"])

ans = logical
   1
ans = 1×2 logical array

   1   0
ans = logical
   1

Veja também

startsWith endsWith strfind count regexp