curl_getenv(3) - Man pages

curl_getenv(3)              Library Functions 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() function, meant to
       emulate its behavior and provide an identical interface for all  operat-
       ing systems libcurl builds on (including Windows).

       You must curl_free(3) the returned string when you are done with it.

PROTOCOLS
       This functionality affects all supported protocols

EXAMPLE
       int main(void)
       {
         char *width = curl_getenv("COLUMNS");
         if(width) {
           /* it was set */
           curl_free(width);
         }
       }

AVAILABILITY
       Added in curl 7.1

RETURN VALUE
       A  pointer  to a null-terminated string or NULL if it failed to find the
       specified name.

NOTE
       Under Unix operating systems, there is no point in  returning  an  allo-
       cated  memory,  although other systems does not work properly if this is
       not done. The Unix implementation thus suffers slightly from  the  draw-
       backs of other systems.

SEE ALSO
       getenv(3C)

libcurl                            2026-07-12                    curl_getenv(3)

Generated by dwww version 1.16 on Sat Oct 3 07:40:26 CEST 2026.