GETENV()
 Obtiene el contenido de una variable de entorno del DOS
------------------------------------------------------------------------------
 Sintaxis

     GETENV(<cVariableEntorno>) --> cCadena

 Argumentos

     <cVariableEntorno> es el nombre de la variable de entorno del DOS.
     Cuando se especifica este argumento, puede utilizarse cualquier
     combinación de letras mayúsculas y minúsculas; GETENV() no distingue
     mayúsculas y minúsculas.

 Devuelve

     GETENV() devuelve el contenido de la variable de entorno del DOS
     especificada como una cadena de caracteres. Si no se puede localizar la
     variable, GETENV() devuelve una cadena nula ("").

 Descripción

     GETENV() es una función de entorno que le permite obtener información
     del entorno del DOS en un programa de aplicación. Normalmente, ésta es
     la información de la configuración, incluyendo los nombres de vía que
     proporcionan la situación de los ficheros (base de datos, índice,
     etiquetas o informes). Esta función es particularmente útil en
     entornos de red.

 Notas

     ■ Valor de retorno vacío: Si está seguro de que existe una
        variable de entorno y GETENV() devuelve siempre una cadena nula
        (""), asegúrese de que no existen espacios entre el nombre de
        variable de entorno y el primer carácter de la cadena que se le ha
        asignado en el mandato SET del DOS.

     ■ Compatibilidad: En versiones anteriores de CA-Clipper, la
        función se llamaba GETE(). Esta forma abreviada de GETENV() es
        todavía operativa.

 Ejemplos

      Este ejemplo obtiene el valor actual de PATH del DOS,
        convirtiéndola en la vía actual de CA-Clipper:

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

      Este ejemplo utiliza variables de entorno para configurar la
        situación específica de los ficheros. Cuando se configura un
        sistema, se definen variables de entorno que contienen la situación
        de varios tipos de fichero, así como la variable de entorno CLIPPER
        (consulte el capítulo "Entorno de Ejecución" en la Guía de
        Programación y Utilidades), de forma análoga a lo siguiente:

        C>SET LOC_DBF=<vía de ficheros de base de datos>
        C>SET LOC_NTX=<vía de ficheros de índice>
        C>SET LOC_RPT=<vía de ficheros de informe>

        En la sección de configuración del programa de aplicación, asigne el
        contenido de las variables de entorno a variables. Posteriormente,
        cuando acceda a un fichero, haga preceder la referencia con la
        variable de vía, del modo siguiente:

        cDdfDirectorio := GETENV("LOC_DBF")
        USE (cDdfDirectorio + "Facturas")

 Ficheros   La biblioteca asociada es CLIPPER.LIB.