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.

Protocols

All

Example

int main(void)
{
  CURL *handle;
  struct curl_slist *slist = NULL;
 
  slist = curl_slist_append(slist, "X-libcurl: coolness");
 
  if(!slist)
    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.

See also

curl_slist_append(3)

This HTML page was made with roffit.