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 entires 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.
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 a C manual.
If a conversion character s is used an element read may cause
several MATLAB matrix elements to be used, each holding one
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.
S = fscanf(fid,'%s') reads (and returns) a character string.
A = fscanf(fid,'%5d') reads 5-digit decimal integers.
See also FPRINTF , SSCANF , FREAD .