DataMuseum.dk

top - download

    Length: 3655 (0xe47)
    Types: TextFile
    Names: »V«

└─⟦afbc8121e⟧ Bits:30000532 8mm tape, Rational 1000, MC68020_OS2000 7_2_2
    └─ ⟦77aa8350c⟧ »DATA« 
        └─⟦f794ecd1d⟧ 
            └─⟦4c85d69e2⟧ 
                └─⟦this⟧ 

TextFile

--    The use of this system is subject to the software license terms and
--    conditions agreed upon between Rational and the Customer.
--
--                Copyright 1988 by Rational.
--
--                          RESTRICTED RIGHTS LEGEND
--
--    Use, duplication, or disclosure by the Government is subject to
--    restrictions as set forth in subdivision (b)(3)(ii) of the Rights in
--    Technical Data and Computer Software clause at 52.227-7013.
--
--
--                Rational
--                3320 Scott Boulevard
--                Santa Clara, California 95054-3197
--
--   PROPRIETARY AND CONFIDENTIAL INFORMATION OF RATIONAL;
--   USE OR COPYING WITHOUT EXPRESS WRITTEN AUTHORIZATION
--   IS STRICTLY PROHIBITED.  THIS MATERIAL IS PROTECTED AS
--   AN UNPUBLISHED WORK UNDER THE U.S. COPYRIGHT ACT OF
--   1976.  CREATED 1988.  ALL RIGHTS RESERVED.
--
--

package Command_Line is

    -- The OS-9 shell performs system specific processing of the
    -- command line when a program is invoked.  Chapter 5 of the
    -- OS-9 Operating System User's Manual contains a description
    -- of the processing and the special characters used to denote
    -- wildcards, execution modifiers, and separators.  Additional
    -- parameters from the command line are passed to the executing
    -- program as a sequence of characters.  This package provides
    -- access to these parameters.

    -- The character sequence passed to the program consists of two
    -- parts.  The first part contains the remaining, unprocessed
    -- parameters from the command line used to invoke the program.
    -- The second part consists of a text representation of all
    -- values of environment variables for the program.  Environment
    -- parameters are passed to the program in the form
    --
    --              name=value
    --

    -- These two parts of the character sequence are separated by
    -- the an  Ascii.Nul or an  Ascii.Cr.  Individual parameters
    -- are separated by a single space.

    -- In the operations below, the first part of the character
    -- sequence is identified by the name "Parameter", and the
    -- second part is identified by the name "Environment".


    function Length_Of_Parameters return Natural;
    -- returns the length of the parameter part.

    function Parameters return String;
    -- returns the parameter part of the command line; that is,
    -- the part of the character sequence up to but not including
    -- the first Ascii.Nul.

    function Contains_Substring
                (S : String; Case_Insensitive : Boolean := True) return Boolean;
    -- returns True iff the parameter part contains a substring
    -- which is equal to the given string.  Whether the equality
    -- is case-insensitive or not is determined by the parameter.


    function Length_Of_Environment return Natural;
    -- returns the length of the environment part.

    function Environment return String;
    -- returns the full string representing the settings of
    -- environment variables, which was passed to the program;
    -- that is, the part of the character sequence after the
    -- Ascii.Nul & Ascii.Cr, but before the next Ascii.Nul.

    function Environment_Value
                (Name : String; Case_Insensitive : Boolean := True)
                return String;
    -- returns the value associated with the given variable;
    -- does a search of the environment part for the substring
    -- Name & '=', and returns the sequence of characters after
    -- the '=', but before the next ' '.  Whether the search is
    -- done case-insensitive is determined by the parameter.

end Command_Line;