GETENV()
 Carrega o conteúdo de uma variável ambiental do DOS
------------------------------------------------------------------------------

 Sintaxe

     GETENV(<cVariavelAmbiental>) --> cString

 Argumentos

     <cVariavelAmbiental> é o nome da variável ambiental do DOS.  Ao
     especificar este argumento, você pode utilizar qualquer combinaçao de
     letras maiúculas e minúsculas; GETENV() nao faz diferenciaçao entre
     estes tipos de letras.

 Retorno

     GETENV() retorna o conteúdo da variável ambiental DOS especificada na
     forma de uma cadeia de caracteres.  Caso a variável nao possa ser
     encontrada, GETENV() retorna uma cadeia de caracteres nula ("").

 Descriçao

     GETENV() é uma funçao de tratamento de ambiente que permite a você
     configurar informaçoes do ambiente DOS para um programa de aplicaçao.
     Normalmente, estas seriam informaçoes de configuraçao, inclusive nomes
     de path, que fornecem a localizaçao de arquivos (banco de dados,
     índice, etiqueta, ou relatório).  Esta funçao é extremamente útil para
     ambientes de rede.

 Notas

       Valor de retorno vazio: Caso você tenha certeza de que
        existe uma variável ambiental e, mesmo assim, GETENV() sempre
        retorna uma cadeia de caracteres nula (""), assegure-se de que nao
        há espaços em branco entre a variável ambiental e o primeiro
        caractere da cadeia atribuida a ela no comando SET do DOS.

       Compatibilidade: Nas versoes anteriores do Clipper, esta
        funçao chamava-se GETE().  Esta forma abreviada de GETENV() ainda é
        operacional.

 Exemplos

       Este exemplo carrega a configuraçao corrente do PATH do DOS,
        tornando-a o PATH corrente do Clipper:

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

       Este exemplo demonstra como utilizar variáveis ambientais
        para configurar as localizaçoes específicas dos arquivos.  Ao
        configurar um sistema, defina as variáveis ambientais que contêm a
        localizaçao dos vários tipos de arquivo juntamente com a variável
        ambiental CLIPPER veja o livro Programando e Utilitários), desta
        forma:

        SET LOC_DBF=<path para o arquivo de dados>
        SET LOC_NTX=<path para o arquivo de índices>
        SET LOC_RPT=<path para arquivo de relatórios>

       Na seçao de configuraçao de seu programa de aplicaçao,
        atribua o conteúdo das variáveis ambientais a variáveis.  Depois, ao
        acessar um arquivo, coloque antes da referência a variável de path
        como segue:

        cDdfDirectory = GETENV("LOC_DBF")
        USE (cDdfDirectory + "Invoices")

 Arquivos:  Biblioteca CLIPPER.LIB.