LCS2016_006e < P1076

P1076 Web>VHDL2017>LCS2016_006e (2017-05-03, RobGaddi) (raw view)EditAttach
---+ Language Change Specification for Environment API

---++ 
<sticky>
| *LCS Number:* | LCS-2016-006e  |
| *Version:*    | 5  |
| *Date:*       | 07-Mar-2017   |
| *Status:*     | Approved |
| *Author:*     | [[Main.ThomasPreusser][Thomas Preusser]] |
| *More:*       | [[LCS2016_006e_History][History]] %BR% [[LCS2016_006e_Examples][Examples]] |
| *Summary:*    | Allow access to system environment variables (baseline). |</sticky>

---++ Details of Language Change
---+++ 16.5 Standard environment package
---+++ 16.5.1 General %GREEN%[NEW headline level]%ENDCOLOR%

Package ENV contains declarations that provide a VHDL interface to the host environment.
<pre>package ENV is
  procedure STOP (STATUS: INTEGER);
  procedure STOP;
  procedure FINISH (STATUS: INTEGER);
  procedure FINISH;
 
  function RESOLUTION_LIMIT return DELAY_LENGTH;

  %GREEN%[... LCS-2016-011 ...]%ENDCOLOR%
  %GREEN%[... LCS-2016-006c ...]%ENDCOLOR%

  %RED%impure function GETENV(Name : STRING) return STRING;%ENDCOLOR%
  %RED%impure function GETENV(Name : STRING) return LINE;%ENDCOLOR%

end package ENV;
</pre>

---+++ 16.5.5 System Environment API %GREEN%[NEW]%ENDCOLOR%

%RED%The functions GETENV return the string value of the named environment variable either as type STRING or as the designated value of an access value. %BLUE%Conditional analysis identifiers (24.2) are part of the queried environment and take precedence over possibly inherited environment variables of identical names.%ENDCOLOR% %RED%If the specified variable name is not defined at all in this environment, the return value will be the empty string ("") or  the access value *null*, respectively.%ENDCOLOR%

---++ Comments

%COMMENT%
Topic revision: r33 - 2017-05-03 - 04:57:58 - RobGaddi
P1076