`mustBeText`

Verifica se um valor é texto: caracteres, array de strings ou cell array de vetores de caracteres.

Sintaxe

mustBeText(A)

Verifica se A é texto. Não retorna nada se a verificação passa e lança um erro se não passa.

Descrição

mustBeText é um validador: examina a entrada e retorna em silêncio ou lança um erro com o identificador MATLAB:validators:mustBeText. A mensagem de erro informa o requisito violado, de modo que quem chama vê o que era esperado em vez de uma falha genérica.

São aceitos vetores de caracteres, arrays de strings e cell arrays cujas células contêm todas vetores de caracteres. Um cell array vazio passa. Qualquer outra classe falha.

Argumentos de entrada

A: O valor a verificar. Qualquer array da classe que o validador aceita.

Exemplo

Entrada válida e inválida

mustBeText({'a', 'b'});
disp('passed')
try
    mustBeText(42)
catch err
    disp(err.message)
end

Saída

passed
Value must be a character vector, string array, or cell array of character vectors.

Veja também

mustBeTextScalar mustBeNonzeroLengthText ischar isstring