`mustBeFile`

Verifica se o texto nomeia arquivos existentes.

Sintaxe

mustBeFile(A)

Verifica se todos os caminhos em A se referem a arquivos existentes. Não retorna nada se a verificação passa e lança um erro se não passa.

Descrição

mustBeFile é um validador: examina a entrada e retorna em silêncio ou lança um erro com o identificador MATLAB:validators:mustBeFile. 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.

A pode ser um vetor de caracteres, um array de strings ou um cell array de vetores de caracteres. Um caminho que nomeia uma pasta não passa, pois a verificação é de arquivos. Caminhos relativos são resolvidos a partir da pasta atual.

Argumentos de entrada

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

Exemplo

Entrada válida e inválida

fid = fopen('check.txt', 'w'); fclose(fid);
mustBeFile('check.txt');
disp('passed')
try
    mustBeFile('nofile.xyz')
catch err
    disp(err.message)
end
delete('check.txt')

Saída

passed
The following files do not exist: 'nofile.xyz'.

Veja também

mustBeFolder isfile exist mustBeText