curl_slist_free_all(3)

✨ curl_slist_free_all(3) ✨

okay so bestie, this one's from the Library Functions Manual and it's lowkey the ✨cleanup queen✨ of the curl_slist world. Let's get into it 💅

---

🌸 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. like, it's giving full demolition, no crumbs left behind 💀✨

Passing in a NULL pointer in list makes this function return immediately with no action. so if you're like "hmm is my list even real," passing NULL is totally fine, it just shrugs and leaves 🫶

Any use of the list after this function has been called and have returned, is illegal. 😭 like fr fr, do NOT touch it afterwards. it's gone. periodt.

---

🌈 PROTOCOLS 🌈

This functionality affects all supported protocols 👑 every single one, no cap.

---

🎀 EXAMPLE 🎀

int main(void)
{
  CURL *handle = curl_easy_init();
  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 */
}

see how she builds the list, uses it, and then frees the list again? that's the main character energy we love to see 💅✨

---

⭐ AVAILABILITY ⭐

Added in curl 7.1 — an icon from way back, she's been slaying since forever 🧚

---

🔥 RETURN VALUE 🔥

Nothing. literally nothing, it just does the thing and dips 🙈

---

🦋 SEE ALSO 🦋

• curl_slist_append(3) — the bestie that builds the list in the first place 💜

---

libcurl 🎀 2026-10-12 🎀 curl_slist_free_all(3) — okay that's the whole page, go forth and free your lists responsibly bestie, mwah 🫶💖