Manual Pages for UNIX Operating System command usage for man curl_getenv

libcurl Manual                                     curl_getenv(3)



NAME
     curl_getenv - return value for environment name

SYNOPSIS
     #include 

     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 so the application must free() this when the data
     is  no  longer needed. 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 has to suffer slightly from the drawbacks of other sys-
     tems.

SEE ALSO
     getenv(3C),

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     _______________________________________
    |   ATTRIBUTE TYPE   |  ATTRIBUTE VALUE|
    |____________________|__________________|_
    | Availability       |  web/curl       |
    |____________________|__________________|_
    | Interface Stability|  Uncommitted    |
    |____________________|_________________|

NOTES
     Source for C-URL is available on http://opensolaris.org.





libcurl 7.12       Last change: 30 April 2004                   1