getenv, _wgetenv

Získá hodnotu z aktuálního prostředí. K dispozici jsou bezpečnější verze těchto funkcí; viz getenv_s, _wgetenv_s.

Syntaxe

char *getenv(
   const char *varname
);
wchar_t *_wgetenv(
   const wchar_t *varname
);

Parametry

varname
Název proměnné prostředí

Vrácená hodnota

Vrátí ukazatel na položku tabulky prostředí obsahující varname. Není bezpečné upravit hodnotu proměnné prostředí pomocí vráceného ukazatele. _putenv Pomocí funkce můžete upravit hodnotu proměnné prostředí. Vrácená hodnota je NULL , pokud varname se v tabulce prostředí nenajde.

Poznámky

Funkce getenv vyhledá seznam proměnných varnameprostředí . getenv nerozlišuje velká a malá písmena v operačním systému Windows. getenv a _putenv použijte kopii prostředí, na kterou odkazuje globální proměnná _environ pro přístup k prostředí. getenv funguje pouze u datových struktur, které jsou přístupné pro knihovnu za běhu, a ne v prostředí "segmentu" vytvořeném pro proces operačním systémem. Programy, které používají envp argument nebo main wmain mohou načíst neplatné informace.

Pokud varname ano NULL, tato funkce vyvolá neplatnou obslužnou rutinu parametru, jak je popsáno v ověření parametru. Pokud je spuštění povoleno pokračovat, tato funkce nastaví errno EINVAL a vrátí NULL.

_wgetenv je verze širokého znaku getenv; argument a návratová _wgetenv hodnota jsou řetězce širokých znaků. Globální _wenviron proměnná je širokoznační verze _environ.

V programu MBCS (například v programu SBCS ASCII) _wenviron je zpočátku NULL , protože prostředí se skládá z vícebajtových řetězců znaků. Pak se při prvním volání nebo _wputenvpři prvním volání _wgetenv , pokud již existuje prostředí (MBCS), vytvoří se odpovídající prostředí řetězce širokého znaku a pak bude odkazovat na _wenviron.

Podobně v programu Unicode (_wmain) je zpočátkuNULL, _environ protože prostředí se skládá z řetězců širokých znaků. Pak se při prvním volání nebo _putenvpři prvním volání getenv , pokud již existuje prostředí (Unicode), vytvoří se odpovídající prostředí MBCS a pak odkazuje na _environ.

Pokud v programu existují současně dvě kopie prostředí (MBCS a Unicode), musí systém za běhu udržovat obě kopie, což vede k pomalejší době provádění. Například při každém volání _putenvse volání _wputenv spustí automaticky, aby dva řetězce prostředí odpovídaly.

Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.

Mapování rutin obecného textu

Pokud chcete zkontrolovat nebo změnit hodnotu TZ proměnné prostředí, použijte getenv_putenv a _tzset podle potřeby. Další informaceochch TZ_tzset _daylighttimezone_tzname

Požadavky

Další informace o kompatibilitě najdete v tématu Kompatibilita.

Příklad

// crt_getenv.c
// compile with: /W3
// This program uses getenv to retrieve
// the LIB environment variable and then uses
// _putenv to change it to a new value.

#include <stdlib.h>
#include <stdio.h>

int main( void )
{
   char *libvar;

   // Get the value of the LIB environment variable.
   libvar = getenv( "LIB" ); // C4996
   // Note: getenv is deprecated; consider using getenv_s instead

   if( libvar != NULL )
      printf( "Original LIB variable is: %s\n", libvar );

   // Attempt to change path. Note that this only affects the environment
   // variable of the current process. The command processor's
   // environment is not changed.
   _putenv( "LIB=c:\\mylib;c:\\yourlib" ); // C4996
   // Note: _putenv is deprecated; consider using putenv_s instead

   // Get new value.
   libvar = getenv( "LIB" ); // C4996

   if( libvar != NULL )
      printf( "New LIB variable is: %s\n", libvar );
}

Original LIB variable is: C:\progra~1\devstu~1\vc\lib
New LIB variable is: c:\mylib;c:\yourlib

Viz také

Řízení procesů a prostředí
_putenv, _wputenv
Konstanty prostředí