FreeBSD Manual 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 2025-06-03 curl_getenv(3)
NAME | SYNOPSIS | DESCRIPTION | PROTOCOLS | EXAMPLE | AVAILABILITY | RETURN VALUE | NOTE | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=curl_getenv&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>