PAL CARD CATALOG ENTRY

SHORT DESCRIPTION

Command Line Interface


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

ASSET PROFILE

UNIT NAME
Abstractions/CLI (A1CLI)
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 12:52:51Pm
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             527
Statements        186
Comments          143

Unidentified Withed Units --
3 unidentified withed units

FILE LISTING

Directory Display


languages/ada/asr/abstractions/cli:
  File Name                 Size
  ---------                 ----
  cli.zip                  3,955


Totals
  ==============  ==============
    1 Files                3,955

ABSTRACT

	This package provides a universal and portable interface to the
arguments typed on a command line when a program is invoked.  Each
command line argument is either a Word (sequence of non-blank
characters) or a quoted string, with embedded quotes doubled.
	Both named and positional arguments may be given on the command
line.  However, once a named parameter is used, all the subsequent
parameters on the command line must be named parameters.  For example,
the command

		compile abc pqr xyz library=>plib

has one named argument and three positional arguments.  Likewise,

		compile abc,pqr,unit=>xyz,library=>plib

has two named arguments and two positional arguments.  This package
separates the named parameters from the positional parameters,
ignores spaces around the "bound to" (=>) symbol, and allows
parameters to be separated by either spaces or commas, so these
command lines are indistinguishable.
	At program elaboration time, the command line string is automatically
objected from the host operating system and parsed into individual
arguments.  The following operations may then be used:

Named_Arg_Count              Number of named arguments entered
Positional_Arg_Count         Number of positional arguments entered
Positional_Arg_Value(N)      The Nth positional argument
Named_Arg_Value(Name,Value)  The value of a named argument
Arguments                    The entire command line

	This package is specific to VAX/VMS.
        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.