$FUNCNAME$
  GETENV()
$CATEGORY$
  SYSTEM,ENVIRONMENT
$SUMMARY$
   Retrieve the contents of a OS environment variable
$LANG_RU$
       OS.
$SYNTAX$
     GETENV(<cEnvironmentVariable>) --> cString
$LANG_RU$
     GETENV (<  OS>) --> 
$ARGUMENTS$
     <cEnvironmentVariable> is the name of the OS environment variable.
     When specifying this argument, you can use any combination of uppercase
     and lowercase letters; GETENV() is not case-sensitive.
$LANG_RU$
     <  OS> -     OS.  
            
      : GETENV()   .
$RETURNS$
     GETENV() returns the contents of the specified OS environment variable
     as a character string.  If the variable cannot be found, GETENV()
     returns a null string ("").
$LANG_RU$
     GETENV()      OS  
      .      , GETENV()
        ("").
$DESCRIPTION$
     GETENV() is an environment function that lets you retrieve information
     from the OS environment into an application program.  Typically, this
     is configuration information, including path names, that gives the
     location of files (database, index, label, or reports).  This function
     is particularly useful for network environments.
$LANG_RU$
     GETENV() -   ,     
           OS. 
     ,      (  , ,
       ).        .
$EXAMPLES$
       This example retrieves the current OS PATH setting, making it
	the current xClipper PATH:

	cPath := GETENV("PATH")
	SET PATH TO (cPath)

       This example uses environment variables to configure the
	specific locations of files.  When you set up a system, define
	environment variables that contain the location of various file types
	as well as the xCLIPPER environment variable.

	C>SET LOC_DBF=<database file path>
	C>SET LOC_NTX=<index file path>
	C>SET LOC_RPT=<report file path>

	In the configuration section of your application program, assign the
	contents of the environment variables to variables.  Then when you
	access a file, preface the reference with the path variable as
	follows:

	cDdfDirectory := GETENV("LOC_DBF")
	USE (cDdfDirectory + "Invoices")
$LANG_RU$
              OS,
           xClipper:

       cPath = GETENV("PATH")
       SET PATH TO (cPath)

        ,    ,
            .  
        ,   , 
              
        xClipper.

       SET LOC_DBF=<     >
       SET LOC_NTX=<   >
       SET LOC_RPT=<    >

            
          . ,     
       ,      PATH,  
       :

       cDbfDirectory = GETENV("LOC_DBF")
       USE (cDbfDirectory + "Invoices")
$SEEALSO$

$END$
