Help for ASCNUM

PURPOSE:
!!! ascnum returns a "real" TCL value !!!
ascnum gets a numeric value and puts it into a TAE TCL
variable.  It finds the number value after the keyword.
The number does not have to be in the same line as the
keyword.


EXECUTION:

Examples

ascnum LOCATIONS seq=7 val=latitude keyword=lat

          gets the number value after the 7th occurrence of
          keyword "lat" and puts it into the TCL variable
          latitude

ascnum LOCATIONS seq=2 lineno=10 keyword=lat val=latitude

          skips to line 10 in file LOCATIONS, get the number
          after the 2nd occurrence of keyword lat and puts
          it into TCL variable latitude

OPERATION:
ascnum does not use VICAR I/O.  It uses C I/O to parse the
input per the parameters to find the value to put into the 
TCL variable.
 TIMING: 

As fast as C can read the lines.  

 ORIGINAL PROGRAMMER:    P. Kim              18 Apr 2009
 COGNIZANT PROGRAMMER:   P. Kim              18 Apr 2009
 
 REVISION HISTORY
  2009-04-18    PK   Initial version