%LOAD Load workspace variables from disk.
%   LOAD FNAME  retrieves the variables from the MAT-file 'fname.mat'.
%
%   LOAD FILENAME retrieves the variables from a MAT-file given a full
%   pathname or a MATLABPATH relative partial pathname (see
%   PARTIALPATH).
%
%   LOAD, by itself, loads from the file named 'matlab.mat'.
%
%   LOAD FNAME X Y Z ... loads just the specified variables.  The
%   wildcard '*' can be used to load variables that match a pattern.
%
%   LOAD FNAME.EXT  reads ASCII files that contain rows of space
%   separated values.  The file can contain MATLAB-style comments that
%   begin with a percent character '%'.  The resulting data is placed into
%   a variable with the same name as the file (without the extension).
%   If the file name begins with a digit or an underscore, a X is prepended
%   to the name. All non-alphanumeric characters in the file name are
%   replaced with underscores.
%
%   LOAD FNAME -ASCII or LOAD FNAME -MAT  can be used to force LOAD to
%   treat the file as either an ASCII file or a MAT file. 
%
%   S = LOAD(...) returns the contents of a MAT-file as a structure
%   instead of directly loading the file into the workspace.  The field
%   names in S match the names of the variables that were retrieved.  When
%   the file is ASCII, S will be a double precision array.
%
%   Use the functional form of LOAD, such as LOAD('fname'), when the
%   file name is stored in a string or when an output argument is
%   requested.
%   
%   See also SAVE, WHOS, DLMREAD, SPCONVERT, FSCANF, FPRINTF, PARTIALPATH.

%   Copyright (c) 1984-98 by The MathWorks, Inc.
%   $Revision: 5.17 $  $Date: 1998/03/02 23:47:48 $
%   Built-in function.
