FSCANF

 

 Read formatted data from file.

  [A,COUNT] = FSCANF(FID,FORMAT478570,SIZE281GDAB) reads data from the file specified

  by file identifier FID, converts it according to the specified FORMAT478570

  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 FOPENZTI1WQ.

 

 

         SIZE281GDAB 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.

 

 

  FORMAT478570 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

  character.

 

 

         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 SIZE281GDAB 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 FPRINTF1H1C3CP, SSCANF79JI56, FREAD12IDRWQ.