---
name: "curl_slist_free_all"
section: "3"
platform: "macos"
package: "curl"
version: "166.0.0.0.1"
release: "macOS 26.5"
platforms: ["linux", "macos"]
url: "https://new.carta.tech/curl_slist_free_all"
---

# curl\_slist\_free\_all(3)

free an entire 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

```
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)](/curl_slist_append/3.md)