c_cpp/etc/calc/help/scan

   1 NAME
   2    scan - scan standard input for possible assignment to variables
   3
   4 SYNOPSIS
   5    scan(x_1, x_2, ..., x_n)
   6
   7 TYPES
   8     x_1, x_2, ...       any
   9
  10     return              integer
  11
  12 DESCRIPTION
  13    When input is from a terminal, execution is halted and input is read
  14    until a newline is entered.  Strings of non-whitespace characters
  15    are evaluated in succession and if the corresponding x_i is an lvalue,
  16    the resulting value is assigned to x_i.  If the number of strings
  17    read exceeds n, only the first n strings are evaluated.  If the number
  18    of strings is less than n, the later x_i are ignored.
  19
  20 EXAMPLE
  21     ; global a, b, c, d;
  22     ; scan(a, 0, c, d)
  23     ; 2+3    b=a^2        3+4i     3+"a"
  24     ; print a,b,c,d
  25         5 25 3+4i Error 3
  26
  27 LIMITS
  28     The number of arguments is not to exceed 1024.
  29
  30 LINK LIBRARY
  31     int scanfstr(char *str, char *fmt, int count, VALUE **vals);
  32
  33 SEE ALSO
  34     fscan, strscan, fscanf, strscanf, scanf, printf, fprintf
  35
  36 ## Copyright (C) 1999-2006  Landon Curt Noll
  37 ##
  38 ## Calc is open software; you can redistribute it and/or modify it under
  39 ## the terms of the version 2.1 of the GNU Lesser General Public License
  40 ## as published by the Free Software Foundation.
  41 ##
  42 ## Calc is distributed in the hope that it will be useful, but WITHOUT
  43 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  44 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
  45 ## Public License for more details.
  46 ##
  47 ## A copy of version 2.1 of the GNU Lesser General Public License is
  48 ## distributed with calc under the filename COPYING-LGPL.  You should have
  49 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
  50 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  51 ##
  52 ## @(#) $Revision: 30.1 $
  53 ## @(#) $Id: scan,v 30.1 2007/03/16 11:10:42 chongo Exp $
  54 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/scan,v $
  55 ##
  56 ## Under source code control:   1996/04/30 03:05:18
  57 ## File existed as early as:    1996
  58 ##
  59 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
  60 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/