help/strscan

   1 NAME
   2    strscan - scan a string for possible assignment to variables
   3
   4 SYNOPSIS
   5    strscan(str, x_1, x_2, ..., x_n)
   6
   7 TYPES
   8     str                 string
   9     x_1, x_2, ...       any
  10
  11     return              integer
  12
  13 DESCRIPTION
  14    Successive fields of str separated by white space are read and
  15    evaluated so long as values remain in the x_i arguments;  when the
  16    x_i corresponding to the field is an lvalue the value obtained for the
  17    i-th field is assigned to x_i.
  18
  19    The function returns the number of fields evaluated.
  20
  21 EXAMPLE
  22     global a,b
  23     > strscan(" 2+3  a^2  print(b)", a, b, 0);
  24     25
  25         3
  26     > print a,b
  27     5 25
  28
  29 LIMITS
  30     none - XXX - is this correct?
  31
  32 LINK LIBRARY
  33     none - XXX - is this correct?
  34
  35 SEE ALSO
  36     scan, fscan, fscanf, strscanf, scanf, printf, fprintf
  37