MATLAB Function Reference

exist - Check existence of variable, function, directory, or Java™ programming language class

Graphical Interface

As an alternative to the exist function, use the Workspace Browser or the Current Directory Browser.

Syntax

exist name
exist name kind
A = exist('name','kind')

Description

exist name returns the status of name:

exist name kind returns the status of name for the specified kind. If name of type kind does not exist, it returns 0. The kind argument may be one of the following:

If name belongs to more than one category (e.g., if there are both an M-file and variable of the given name) and you do not specify a kind argument, exist returns one value according to the order of evaluation shown in the table below. For example, if name matches both a directory and M-file name, exist returns 7, identifying it as a directory.

A = exist('name','kind') is the function form of the syntax.

Remarks

If name specifies a filename, that filename may include an extension to preclude conflicting with other similar filenames. For example, exist('file.ext').

If name specifies a filename, MATLAB attempts to locate the file, examines the filename extension, and determines the value to return based on the extension alone. MATLAB does not examine the contents or internal structure of the file.

You can specify a partial path to a directory or file. A partial pathname is a pathname relative to the MATLAB path that contains only the trailing one or more components of the full pathname. For example, both of the following commands return 2, identifying mkdir.m as an M-file. The first uses a partial pathname:

exist('matlab/general/mkdir.m')
exist([matlabroot '/toolbox/matlab/general/mkdir.m'])

If a file or directory is not on the search path, then name must specify either a full pathname, a partial pathname relative to MATLABPATH, a partial pathname relative to your current directory, or the file or directory must reside in your current working directory.

If name is a Java class, then exist('name') returns an 8. However, if name is a Java class file, then exist('name') returns a 2.

Remarks

To check for the existence of more than one variable, use the ismember function. For example,

a = 5.83;
c = 'teststring';
ismember({'a','b','c'},who)

ans =

     1     0     1

Examples

This example uses exist to check whether a MATLAB function is a built-in function or a file:

type = exist('plot')
type =
5

This indicates that plot is a built-in function.

In the next example, exist returns 8 on the Java class, Welcome, and returns 2 on the Java class file, Welcome.class:

exist Welcome
ans =
     8

exist javaclasses/Welcome.class
ans =
     2

indicates there is a Java class Welcome and a Java class file Welcome.class.

The following example indicates that testresults is both a variable in the workspace and a directory on the search path:

exist('testresults','var')
ans =
     1
exist('testresults','dir')
ans =
     7

See Also

assignin, computer, dir, evalin, help, inmem, isfield, isempty, lookfor, mfilename, partialpath, what, which, who

exifread

exit