NAME

       curl_slist_append - add a string to an slist

SYNOPSIS

       #include <curl/curl.h>

       struct curl_slist *curl_slist_append(struct curl_slist *list, const char * string);

DESCRIPTION

       curl_slist_append(3)  appends  a  string  to  a  linked list of strings. The existing list
       should be passed as the first argument and the new list is returned  from  this  function.
       Pass  in  NULL  in  the  list argument to create a new list. The specified string has been
       appended when this function returns. curl_slist_append(3) copies the string.

       The list should be freed again (after usage) with curl_slist_free_all(3).

RETURN VALUE

       A null pointer is returned if anything went wrong,  otherwise  the  new  list  pointer  is
       returned.

EXAMPLE

       CURL *handle;
       struct curl_slist *slist=NULL;

       slist = curl_slist_append(slist, "pragma:");

       if (slist == NULL)
         return -1;

       curl_easy_setopt(handle, CURLOPT_HTTPHEADER, slist);

       curl_easy_perform(handle);

       curl_slist_free_all(slist); /* free the list again */

SEE ALSO

       curl_slist_free_all(3),