curl / libcurl / API / curl_slist_free_all

curl_slist_free_all - free a curl_slist list

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 makes this function return immediately with no action.

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 */

Availability

Always

Return value

Nothing.