curl_getenv - return value for environment name

SYNOPSIS

       #include <curl/curl.h>

       char *curl_getenv(const char *name);

DESCRIPTION

       curl_getenv() is a portable wrapper for the getenv() func-
       tion, meant to emulate its behaviour and provide an  iden-
       tical  interface  for all operating systems libcurl builds
       on (including win32).

RETURN VALUE

       If successful, curl_getenv()  returns  a  pointer  to  the
       value  of  the specified environment. The memory it refers
       to is malloc()ed why the application must free() this when
       the   data  has  completed  to  serve  its  purpose.  When
       curl_getenv() fails to find the specified name, it returns
       a null pointer.

NOTE

       Under  unix  operating  systems,  there isn't any point in
       returning an  allocated  memory,  although  other  systems
       won't work properly if this isn't done. The unix implemen-
       tation thus have to suffer slightly from the drawbacks  of
       other systems.

SEE ALSO

       getenv(3C),

BUGS

       Surely there are some, you tell me!