Scroll to navigation

curl_slist_free_all(3) libcurl Manual curl_slist_free_all(3)

NAME

curl_slist_free_all - free an entire curl_slist list

SYNOPSIS

#include <curl/curl.h>

void curl_slist_free_all(struct curl_slist *list);

DESCRIPTION

curl_slist_free_all() removes all traces of a previously built curl_slist linked list.

Passing in a NULL pointer in list will make this function return immediately with no action.

RETURN VALUE

Nothing.

EXAMPLE

CURL *handle;
struct curl_slist *slist=NULL;
slist = curl_slist_append(slist, "X-libcurl: coolness");
if (slist == NULL)
  return -1;
curl_easy_setopt(handle, CURLOPT_HTTPHEADER, slist);
curl_easy_perform(handle);
curl_slist_free_all(slist); /* free the list again */

SEE ALSO

curl_slist_append(3),
November 5, 2020 libcurl 7.74.0