`exist`

Verifica se existe uma variável, arquivo, pasta ou função, e de que tipo.

Categoria: Programming > Files and Folders

Sintaxe

n = exist(name)

Procura primeiro variáveis, depois arquivos, pastas e funções, e retorna um código.

n = exist(name, type)

Restringe a busca a 'var', 'file', 'dir' ou 'builtin'.

Descrição

O código numérico diz o tipo do item, e zero significa que nada foi encontrado. Uma variável do workspace vence um arquivo de mesmo nome, a menos que type diga outra coisa. Nomes de arquivo são resolvidos na pasta atual e no path.

Para testes que só precisam de sim ou não, isfile, isfolder e isvarname são mais claros, e isfile e isfolder não consultam o path.

Argumentos de entrada

name: Nome a procurar, como texto.
type: Categoria opcional: 'var', 'file', 'dir' ou 'builtin'.

Argumentos de saída

n: 0 não encontrado, 1 variável, 2 arquivo, 5 função interna, 7 pasta.

Exemplo

Códigos para diferentes tipos de item

x = 1;
writelines('hi', 'note.txt');
mkdir results
[exist('x'), exist('note.txt'), exist('results'), exist('sin'), exist('nothing_here')]
exist('results', 'dir')

Saída

ans = 1×5

     1     2     7     5     0
ans = 7

Observações

O MatLivre informa 5 para toda função que implementa de forma nativa, inclusive algumas que são arquivos M no MATLAB (por exemplo median, que o MATLAB informa como 2).

Veja também

isfile isfolder which isvarname who