NAME

     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  identi­
     cal  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 implementation
     thus have to suffer slightly from  the  drawbacks  of  other
     systems.


SEE ALSO

     getenv(3C),


BUGS

     Surely there are some, you tell me!




















Man(1) output converted with man2html