PAL CARD CATALOG ENTRY

SHORT DESCRIPTION

Scan tokens from strings


MOVEMENT WITHIN THE PAL CARD CATALOG
Move to top-level taxonomy
Move to keyword list

ASSET PROFILE

UNIT NAME
Abstractions/SCANNER (A1SCAN)
VERSION
1.0
REVIEW CODE
C1 1.0 B
INET ADDRESS
Not documented in PAL database
AUTHOR
Bill Toscano, Michael Gordon
Intermetrics, Inc,
733 Concord Ave
Cambridge, MA 02138
Contact: Lt. Colonel Falgiano
ESD/SCW
Hanscom AFB, MA 01731
RIGHTS
PUBLIC DOMAIN
COPYRIGHT
(c) 1985 Intermetrics, Inc.
DATE CREATED
15 October 1985
DATE RELEASED
18 March 1985
DATE LAST UPDATED
17 March 1985
LOCATION
ASR
C2MUG
PC-BLUE
ENVIRONMENT
VAX/VMS, DEC Ada
LIMITATIONS
Not documented in PAL database
CERTIFICATION
Ada System Certifier_1 1.0
Date/Time of Processing: Tuesday   24 May       1994 01:26:04Pm
Overall Assessment of System: OK
Classification of System: B
Basis of Classification --
Syntax Errors                               PASS
Completeness                                PASS
Independence from External Libraries        FAIL
Independence from a Specific Ada Compiler   PASS

Explanations for failures --
System withs non-standard library units that are not provided

Number of ...
Files               2
Library Units       2
Lines            1710
Statements        494
Comments          429

Unidentified Withed Units --
1 unidentified withed units

FILE LISTING

Directory Display


languages/ada/asr/abstractions/scanner:
  File Name                 Size
  ---------                 ----
  scanner.zip              5,653


Totals
  ==============  ==============
    1 Files                5,653

ABSTRACT

	This package provides a set of functions used to scan tokens
from strings.  After the function MAKE_SCANNER is called to convert
a string into a SCANNER object, the following functions may be called
to scan various tokens from the SCANNER object:

Make_Scanner        Given a string, returns a SCANNER
Destroy_Scanner     Free storage used by a SCANNER
More                True if unscanned characters remain in a SCANNER
Forward             Advance within the SCANNER
Backward            Back up within the SCANNER
Get                 Return a character from the SCANNER
Next                Get and Advance
Get_String          Return a string containing the SCANNER contents
Get_Remainder       Return a string starting at a given index
Mark                Mark the current index for a Restore
Restore             Restore the previously-marked index
Position            Return the current position of the scanner
Is_Word             True if the scanner is at a non-blank character
Scan_Word           Return sequence of non-blank characters
Is_Number           True if the scanner is at a digit
Scan_Number (2)     Return sequence of decimal digits
Is_Signed_Number    True if the scanner is at a digit or sign
Scan_Signed_Number (2)
                    Return sequence of decimal digits with optional sign
Is_Space            True if scanner is at a space or tab
Scan_Space          Return sequence of spaces or tabs
Skip_Space          Advance past spaces or tabs
Is_Ada_Id           True if scanner is at the first character of an
                    Ada identifier
Scan_Ada_Id         Scan an Ada identifier
Is_Quoted           True if scanner is at a double quote
Scan_Quoted         Return quoted string, doubling embedded quotes
Is_Enclosed         True if scanner is at an enclosing character
Scan_Enclosed       Return enclosed string, doubling embedded enclosing
                    characters
Is_Sequence         True if scanner is at some character in a sequence
Scan_Sequence       Return user-specified sequence of characters
Is_Not_Sequence
Scan_Not_Sequence
Is_Literal          True if scanner is at a literal
Scan_Literal        Return a user-specified literal
Is_Not_Literal
Scan_Not_Literal

	Note: Numbers in parens indicate number of routines of same name
(overloaded).
        ABSTRACTIONS  is  used  by NOSC/WIS tools 5.1.1, 5.1.2, 6.1.2,
and 6.2.  See also NEW_ABSTRACTIONS.


REVISION HISTORY

DATE         VERSION AUTHOR                  HISTORY 
03/85        1.0  Bill Toscano               Initial Release 


RELEASE NOTICE

This prologue must be included in all copies of this software.

This software is copyright by the author.

This software is released to the Ada community.
This software is released to the Public Domain (note:
  software released to the Public Domain is not subject
  to copyright protection).
Restrictions on use or distribution:  NONE


DISCLAIMER

	This software and its documentation are provided "AS IS" and
without any expressed or implied warranties whatsoever.  No warranties
as to performance, merchantability, or fitness for a particular
purpose exist.
	The user is advised to test the software thoroughly before
relying on it.  The user must assume the entire risk and liability of
using this software.  In no event shall any person or organization of
people be held responsible for any direct, indirect, consequential or
inconsequential damages or lost profits.