Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
curl_slist_append(3)		libcurl	Manual		  curl_slist_append(3)

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. To avoid overwriting  an  existing  non-empty
       list  on	 failure, the new list should be returned to a temporary vari-
       able which can be tested	for NULL before	 updating  the	original  list
       pointer.

EXAMPLE
       CURL *handle;
       struct curl_slist *slist=NULL;
       struct curl_slist *temp=NULL;

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

       if (slist == NULL)
	 return	-1;

       temp = curl_slist_append(slist, "Accept:")

       if (temp	== NULL) {
	 curl_slist_free_all(slist);
	 return	-1;
       }

       slist = temp;

       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),

libcurl	7.72.0		       January 02, 2019		  curl_slist_append(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | EXAMPLE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=curl_slist_append&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help