`validatestring`

Confere um texto com uma lista de textos válidos, permitindo abreviações.

Sintaxe

match = validatestring(str, options)

Retorna a entrada de options com a qual str corresponde, ou gera erro se não houver.

Descrição

A comparação ignora maiúsculas e minúsculas e aceita qualquer parte inicial de uma opção, então 'gr' corresponde a 'green'. Uma correspondência exata sempre vence opções mais longas que começam igual. Se o texto for prefixo de várias opções que não são prefixo uma da outra, a correspondência é ambígua e a chamada gera erro; se não corresponder a nenhuma, a mensagem de erro lista todos os valores válidos.

Retornar a grafia completa permite que uma função aceite formas curtas de quem chama e ainda trabalhe com um valor canônico em um switch.

Argumentos de entrada

str: O texto a verificar, normalmente uma opção fornecida pelo usuário.
options: Cell array de vetores de caracteres válidos.

Argumentos de saída

match: A entrada correspondente de options, exatamente como escrita lá.

Exemplo

Abreviações e uma não correspondência

s = validatestring('GR', {'red', 'green'})
try
    validatestring('x', {'red', 'green'})
catch err
    disp(err.message)
end

Saída

s = 'green'
Expected input to match one of these values:

'red', 'green'

The input, 'x', did not match any of the valid values.

Veja também

mustBeMember strcmpi strncmpi inputParser