summaryrefslogtreecommitdiff
path: root/gcc/ada/a-envvar.ads
diff options
context:
space:
mode:
authorupstream source tree <ports@midipix.org>2015-03-15 20:14:05 -0400
committerupstream source tree <ports@midipix.org>2015-03-15 20:14:05 -0400
commit554fd8c5195424bdbcabf5de30fdc183aba391bd (patch)
tree976dc5ab7fddf506dadce60ae936f43f58787092 /gcc/ada/a-envvar.ads
downloadcbb-gcc-4.6.4-554fd8c5195424bdbcabf5de30fdc183aba391bd.tar.bz2
cbb-gcc-4.6.4-554fd8c5195424bdbcabf5de30fdc183aba391bd.tar.xz
obtained gcc-4.6.4.tar.bz2 from upstream website;upstream
verified gcc-4.6.4.tar.bz2.sig; imported gcc-4.6.4 source tree from verified upstream tarball. downloading a git-generated archive based on the 'upstream' tag should provide you with a source tree that is binary identical to the one extracted from the above tarball. if you have obtained the source via the command 'git clone', however, do note that line-endings of files in your working directory might differ from line-endings of the respective files in the upstream repository.
Diffstat (limited to 'gcc/ada/a-envvar.ads')
-rwxr-xr-xgcc/ada/a-envvar.ads59
1 files changed, 59 insertions, 0 deletions
diff --git a/gcc/ada/a-envvar.ads b/gcc/ada/a-envvar.ads
new file mode 100755
index 000000000..9769c9bb1
--- /dev/null
+++ b/gcc/ada/a-envvar.ads
@@ -0,0 +1,59 @@
+------------------------------------------------------------------------------
+-- --
+-- GNAT RUN-TIME COMPONENTS --
+-- --
+-- A D A . E N V I R O N M E N T _ V A R I A B L E S --
+-- --
+-- S p e c --
+-- --
+-- This specification is derived from the Ada Reference Manual for use with --
+-- GNAT. In accordance with the copyright of that document, you can freely --
+-- copy and modify this specification, provided that if you redistribute a --
+-- modified version, any changes that you have made are clearly indicated. --
+-- --
+------------------------------------------------------------------------------
+
+package Ada.Environment_Variables is
+ pragma Preelaborate (Environment_Variables);
+
+ function Value (Name : String) return String;
+ -- If the external execution environment supports environment variables,
+ -- then Value returns the value of the environment variable with the given
+ -- name. If no environment variable with the given name exists, then
+ -- Constraint_Error is propagated. If the execution environment does not
+ -- support environment variables, then Program_Error is propagated.
+
+ function Exists (Name : String) return Boolean;
+ -- If the external execution environment supports environment variables and
+ -- an environment variable with the given name currently exists, then
+ -- Exists returns True; otherwise it returns False.
+
+ procedure Set (Name : String; Value : String);
+ -- If the external execution environment supports environment variables,
+ -- then Set first clears any existing environment variable with the given
+ -- name, and then defines a single new environment variable with the given
+ -- name and value. Otherwise Program_Error is propagated.
+ -- If implementation-defined circumstances prohibit the definition of an
+ -- environment variable with the given name and value, then
+ -- Constraint_Error is propagated.
+ -- It is implementation defined whether there exist values for which the
+ -- call Set (Name, Value) has the same effect as Clear (Name).
+
+ procedure Clear (Name : String);
+ -- If the external execution environment supports environment variables,
+ -- then Clear deletes all existing environment variables with the given
+ -- name. Otherwise Program_Error is propagated.
+
+ procedure Clear;
+ -- If the external execution environment supports environment variables,
+ -- then Clear deletes all existing environment variables. Otherwise
+ -- Program_Error is propagated.
+
+ procedure Iterate
+ (Process : not null access procedure (Name, Value : String));
+ -- If the external execution environment supports environment variables,
+ -- then Iterate calls the subprogram designated by Process for each
+ -- existing environment variable, passing the name and value of that
+ -- environment variable. Otherwise Program_Error is propagated.
+
+end Ada.Environment_Variables;