manpagez: man pages & more
man curl_slist_free_all(3)
Home | html | info | man
curl_slist_free_all(3)     Library Functions 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 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)

libcurl                          March 28 2024          curl_slist_free_all(3)

curl 8.7.1 - Generated Sat Apr 6 14:38:23 CDT 2024
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.