SSCANF

 

 Read string under format control.

  [A,COUNT,ERRMSG,NEXTINDEX] = SSCANF(S,FORMAT478570,SIZE281GDAB) reads data from

  MATLAB string variable S, 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.

         ERRMSG is an optional output argument that returns an error message

  string if an error occurred or an empty matrix if an error did not

  occur. NEXTINDEX is an optional output argument specifyiny one more

  than the number of characters scanned in S.

 

 

  SSCANF is the same as FSCANF1N0KSG5 except that it reads the data from

  a MATLAB string variable rather than reading it from a file.

 

 

  SIZE281GDAB is optional; it puts a limit on the number of elements that

  can be scanned from the string; if not specified, the entire string

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

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

 

 

  Scanning to end-of-string occurs when NEXTINDEX is greater than the

  size of S.

 

 

  SSCANF 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 the string until its end is reached

  or the amount of data specified by SIZE281GDAB is converted in.

 

 

  For example, the statements

 

 

      S = '2.7183  3.1416';

      A = sscanf(S,'%f')

 

 

  create a two element vector containing approximations to e and pi.

 

 

  See also FSCANF1N0KSG5, SPRINTF3EML54, FREAD12IDRWQ.