Obtiene el contenido de una variable de entorno DOS ───────────────────────────────────────────── Sintaxis GETENV() --> cCadena Argumentos 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 es sensible a las 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 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, etiqueta o informes). Esta función es particularmente útil en entornos de red. Notas n 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. n Compatibilidad: En las versiones anteriores de CA-Clipper, la función se llamaba GETE(). Esta forma abreviada de GETENV() es todavía operativa. Ejemplos n 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) n Este ejemplo utiliza variables de entorno para configurar las posiciones específicas de ficheros. Cuando se configura un sistema, se definen variables de entorno que contienen la posició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 Programación y Utilidades), de forma análoga a lo siguiente: C>SET LOC_DBF= C>SET LOC_NTX= C>SET LOC_RPT= 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.