curl/docs/libcurl/curl_free.md
Daniel Stenberg e3fe020089
docs/libcurl: generate PROTOCOLS from meta-data
Remove the PROTOCOLS section from the source files completely and
instead generate them based on the header data in the curldown files.

It also generates TLS backend information for options marked for TLS as
protocol.

Closes #13175
2024-03-23 18:13:03 +01:00

890 B

c SPDX-License-Identifier Title Section Source See-also Protocol
Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. curl curl_free 3 libcurl
curl_easy_escape (3)
curl_easy_unescape (3)
All

NAME

curl_free - reclaim memory that has been obtained through a libcurl call

SYNOPSIS

#include <curl/curl.h>

void curl_free(void *ptr);

DESCRIPTION

curl_free reclaims memory that has been obtained through a libcurl call. Use curl_free(3) 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 ptr makes this function return immediately with no action.

EXAMPLE

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

AVAILABILITY

Always

RETURN VALUE

None