startsWith

Testa se um texto começa com um determinado prefixo.

Categoria: Language Fundamentals > Data Types

Sintaxe

tf = startsWith(str, pat)

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

Descrição

A comparação é feita caractere a caractere desde o início de cada texto. Um prefixo vazio sempre casa. str pode ser uma coleção, então uma só chamada verifica uma lista inteira de nomes.

O prefixo é texto literal, não um padrão: caracteres como * ou . não têm significado especial.

Argumentos de entrada

str

Array de strings, vetor de caracteres ou cell array de vetores de caracteres.

pat

Prefixo procurado, ou vários prefixos. Se qualquer um casar, o resultado é verdadeiro.

'IgnoreCase'

Flag lógico, false por padrão.

Argumentos de saída

tf

Array lógico com um elemento por texto em str.

Exemplo

Texto único, lista e maiúsculas

startsWith("hello world", "hello")
startsWith({'apple','banana','avocado'}, 'a')
startsWith('ABC', 'ab', 'IgnoreCase', true)

ans = logical
   1
ans = 1×3 logical array

   1   0   1
ans = logical
   1

Veja também

endsWith contains strncmp strfind extractBefore