.. highlightlang:: us

.. index:: environment variable
.. index:: getenv

.. _getenv:

getenv
======

.. us.tag  getenv NOTREADYENGLISH getenv

:ref:`getenv` gets a value from the current environment.

.. function::  ssEnvValue = getenv(ssEnvName)

.. us.return

**Return Value**

*ssEnvValue* is the value of the environment variable or an
empty string in case of an error.

.. us.params

**Parameters**

.. uparam:: ssEnvName

   *ssEnvName* is an environment variable name.
   The name is not case sensitive.

.. us.example

**Example**

::

   * getenv("Temp")
   c:\WINNT\Profiles\Admini~1\Locals~1\Temp

   

.. seealso::
   :ref:`putenv`

:sub:`id-837000`