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                          April 26 2024          curl_slist_free_all(3)