File: util-environment.adb

package info (click to toggle)
adabrowse 4.0.2-1
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 2,316 kB
  • ctags: 253
  • sloc: ada: 29,761; makefile: 150; ansic: 4
file content (141 lines) | stat: -rw-r--r-- 3,995 bytes parent folder | download | duplicates (9)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
-------------------------------------------------------------------------------
--
--  <STRONG>Copyright &copy; 2001, 2002 by Thomas Wolf.</STRONG>
--  <BLOCKQUOTE>
--    This piece of software is free software; you can redistribute it and/or
--    modify it under the terms of the  GNU General Public License as published
--    by the Free Software  Foundation; either version 2, or (at your option)
--    any later version. This software is distributed in the hope that it will
--    be useful, but <EM>without any warranty</EM>; without even the implied
--    warranty of <EM>merchantability or fitness for a particular purpose.</EM>
--    See the GNU General Public License for  more details. You should have
--    received a copy of the GNU General Public License with this distribution,
--    see file "<A HREF="GPL.txt">GPL.txt</A>". If not, write to the Free
--    Software Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307,
--    USA.
--  </BLOCKQUOTE>
--  <BLOCKQUOTE>
--    As a special exception from the GPL, if other files instantiate generics
--    from this unit, or you link this unit with other files to produce an
--    executable, this unit does not by itself cause the resulting executable
--    to be covered by the GPL. This exception does not however invalidate any
--    other reasons why the executable file might be covered by the GPL.
--  </BLOCKQUOTE>
--
--  <AUTHOR>
--    Thomas Wolf  (TW) <E_MAIL>
--  </AUTHOR>
--
--  <PURPOSE>
--    Operations on environment variables.
--  </PURPOSE>
--
--  <TASKING>
--    Fully task- and abortion-safe.
--  </TASKING>
--
--  <NO_STORAGE>
--
--  <HISTORY>
--    03-OCT-2001   TW  Initial version.
--    01-MAY-2002   TW  Added 'Expand'.
--    03-MAY-2002   TW  Removed 'Expand', added tagged types and child
--                      packages.
--    27-JUN-2002   TW  Added 'Get_Default' to avoid throwing and immediately
--                      handling the 'Not_Defined' exception.
--  </HISTORY>
-------------------------------------------------------------------------------

pragma License (Modified_GPL);

with Interfaces.C.Strings;

package body Util.Environment is

   use Interfaces.C;
   use Interfaces.C.Strings;

   ----------------------------------------------------------------------------
   --  We use the 'getenv' from the C standard library.

   function Get_Env (Name : in char_array)
     return chars_ptr;
   pragma Import (C, Get_Env, "getenv");

   protected Env is
      function Get (Name : in String)
        return String;

      function Get_Default (Name : in String)
        return String;

   end Env;

   protected body Env is

      function Get
        (Name : in String)
        return String
      is
         C : chars_ptr;
      begin
         begin
            C := Get_Env (To_C (Name));
         exception
            when others =>
               C := Null_Ptr;
         end;
         if C = Null_Ptr then raise Not_Defined; end if;
         return Value (C);
      end Get;

      function Get_Default
        (Name : in String)
        return String
      is
         C : chars_ptr;
      begin
         begin
            C := Get_Env (To_C (Name));
         exception
            when others =>
               C := Null_Ptr;
         end;
         if C = Null_Ptr then return ""; end if;
         return Value (C);
      end Get_Default;

   end Env;

   ----------------------------------------------------------------------------

   function Get
     (Name : in String)
     return String
   is
   begin
      return Env.Get (Name);
   end Get;

   function Safe_Get
     (Name : in String)
     return String
   is
   begin
      if Name'Last < Name'First then return ""; end if;
      return Env.Get_Default (Name);
   end Safe_Get;

   function Get
     (Self : access Expander;
      Name : in     String)
     return String
   is
      pragma Warnings (Off, Self); --  silence -gnatwa
   begin
      return Safe_Get (Name);
   end Get;

end Util.Environment;