%FSCANF Read formatted data from file.
%   [A,COUNT] = FSCANF(FID,FORMAT,SIZE) reads data from the file specified
%   by file identifier FID, converts it according to the specified FORMAT
%   string, and returns it in matrix A. COUNT is an optional output
%   argument that returns the number of elements successfully read. 
%   
%   FID is an integer file identifier obtained from FOPEN.
%   
%   SIZE is optional; it puts a limit on the number of elements that
%   can be read from the file; if not specified, the entire file 
%   is considered; if specified, valid entries are:
%
%       N      read at most N elements into a column vector.
%       inf    read at most to the end of the file.
%       [M,N]  read at most M * N elements filling at least an
%              M-by-N matrix, in column order. N can be inf, but not M.
%
%   If the matrix A results from using character conversions only and
%   SIZE is not of the form [M,N] then a row vector is returned.
%
%   FORMAT is a string containing C language conversion specifications.
%   Conversion specifications involve the character %, optional
%   assignment-suppressing asterisk and width field, and conversion
%   characters d, i, o, u, x, e, f, g, s, c, and [. . .] (scanset).
%   Complete ANSI C support for these conversion characters is
%   provided consistent with 'expected' MATLAB behavior. For a complete
%   conversion character specification, see the Language Reference
%   Guide or a C manual.
%
%   If %s is used an element read may cause several MATLAB matrix
%   elements to be used, each holding one character.  Use %c to read
%   space characters; the format %s skips all white space.
%
%   Mixing character and numeric conversion specifications will cause
%   the resulting matrix to be numeric and any characters read to show
%   up as their ASCII values one character per MATLAB matrix element.
%
%   FSCANF differs from its C language namesake in an important respect -
%   it is "vectorized" in order to return a matrix argument. The format
%   string is recycled through the file until an end-of-file is reached
%   or the amount of data specified by SIZE is read in.
%
%   Examples:
%       S = fscanf(fid,'%s')   reads (and returns) a character string.
%       A = fscanf(fid,'%5d')  reads 5-digit decimal integers.
%
%   See also FPRINTF, SSCANF, TEXTREAD, FGETL, FGETS, FREAD, INPUT.

%   Copyright (c) 1984-98 by The MathWorks, Inc.
%   $Revision: 5.9 $  $Date: 1998/06/22 15:18:29 $
%   Built-in function.
