curl_getenv(3)		 libcurl Manual		   curl_getenv(3)

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).

AVAILABILITY
     This function will be removed from the public libcurl API in
     a near future. It will instead be made "available" by source
     code access only, and then as curlx_getenv().

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(3)
     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),

libcurl 7.12	   Last change: 30 April 2004			1

                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 

Vote for polarhome