2
0
mirror of https://codeberg.org/kiss-community/repo synced 2024-12-23 07:40:11 -07:00
repo/core/curl/files/curl_free.3
2024-08-02 20:52:59 -05:00

38 lines
905 B
Groff

.\" generated by cd2nroff 0.1 from curl_free.md
.TH curl_free 3 "2024-08-02" libcurl
.SH NAME
curl_free \- reclaim memory that has been obtained through a libcurl call
.SH SYNOPSIS
.nf
#include <curl/curl.h>
void curl_free(void *ptr);
.fi
.SH DESCRIPTION
curl_free reclaims memory that has been obtained through a libcurl call. Use
\fIcurl_free(3)\fP instead of free() to avoid anomalies that can result from
differences in memory management between your application and libcurl.
Passing in a NULL pointer in \fIptr\fP makes this function return immediately
with no action.
.SH PROTOCOLS
This functionality affects all supported protocols
.SH EXAMPLE
.nf
int main(void)
{
char *width = curl_getenv("COLUMNS");
if(width) {
/* it was set! */
curl_free(width);
}
}
.fi
.SH AVAILABILITY
Added in curl 7.1
.SH RETURN VALUE
None
.SH SEE ALSO
.BR curl_easy_escape (3),
.BR curl_easy_unescape (3)