1 ------------------------------------------------------------------------------
3 -- GNAT RUNTIME COMPONENTS --
5 -- A D A . C O M M A N D _ L I N E . E N V I R O N M E N T --
10 -- Copyright (C) 1996-2001 Free Software Foundation, Inc. --
12 -- GNAT is free software; you can redistribute it and/or modify it under --
13 -- terms of the GNU General Public License as published by the Free Soft- --
14 -- ware Foundation; either version 2, or (at your option) any later ver- --
15 -- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
16 -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
17 -- or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License --
18 -- for more details. You should have received a copy of the GNU General --
19 -- Public License distributed with GNAT; see file COPYING. If not, write --
20 -- to the Free Software Foundation, 59 Temple Place - Suite 330, Boston, --
21 -- MA 02111-1307, USA. --
23 -- As a special exception, if other files instantiate generics from this --
24 -- unit, or you link this unit with other files to produce an executable, --
25 -- this unit does not by itself cause the resulting executable to be --
26 -- covered by the GNU General Public License. This exception does not --
27 -- however invalidate any other reasons why the executable file might be --
28 -- covered by the GNU Public License. --
30 -- GNAT was originally developed by the GNAT team at New York University. --
31 -- Extensive contributions were provided by Ada Core Technologies Inc. --
33 ------------------------------------------------------------------------------
35 package Ada
.Command_Line
.Environment
is
37 function Environment_Count
return Natural;
38 -- If the external execution environment supports passing the environment
39 -- to a program, then Environment_Count returns the number of environment
40 -- variables in the environment of the program invoking the function.
41 -- Otherwise it returns 0. And that's a lot of environment.
43 function Environment_Value
(Number
: in Positive) return String;
44 -- If the external execution environment supports passing the environment
45 -- to a program, then Environment_Value returns an implementation-defined
46 -- value corresponding to the value at relative position Number. If Number
47 -- is outside the range 1 .. Environment_Count, then Constraint_Error is
50 -- in GNAT: Corresponds to envp [n-1] (for n > 0) in C.
52 end Ada
.Command_Line
.Environment
;