2002-03-04 05:09:48 -05:00
|
|
|
.\" You can view this file with:
|
|
|
|
|
.\" nroff -man [file]
|
|
|
|
|
.\" $Id$
|
|
|
|
|
.\"
|
2003-06-26 07:41:08 -04:00
|
|
|
.TH curl_slist_append 3 "19 Jun 2003" "libcurl 7.10.4" "libcurl Manual"
|
2002-03-04 05:09:48 -05:00
|
|
|
.SH NAME
|
|
|
|
|
curl_slist_append - add a string to an slist
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.B #include <curl/curl.h>
|
|
|
|
|
.sp
|
|
|
|
|
.BI "struct curl_slist *curl_slist_append(struct curl_slist *" list,
|
|
|
|
|
.BI "const char * "string ");"
|
|
|
|
|
.ad
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
curl_slist_append() appends a specified string to a linked list of
|
2003-02-21 10:19:50 -05:00
|
|
|
strings. The existing \fIlist\fP should be passed as the first argument while
|
|
|
|
|
the new list is returned from this function. The specified \fIstring\fP has
|
2003-06-26 07:41:08 -04:00
|
|
|
been appended when this function returns. curl_slist_append() copies the
|
|
|
|
|
string.
|
2003-02-21 10:19:50 -05:00
|
|
|
|
2004-02-27 10:34:06 -05:00
|
|
|
The list should be freed again (after usage) with
|
|
|
|
|
\fBcurl_slist_free_all(3)\fP.
|
2002-03-04 05:09:48 -05:00
|
|
|
.SH RETURN VALUE
|
|
|
|
|
A null pointer is returned if anything went wrong, otherwise the new list
|
|
|
|
|
pointer is returned.
|
2003-02-21 10:19:50 -05:00
|
|
|
.SH EXAMPLE
|
2007-01-09 13:58:16 -05:00
|
|
|
.nf
|
2003-02-21 10:19:50 -05:00
|
|
|
CURL handle;
|
2007-01-09 13:58:16 -05:00
|
|
|
struct curl_slist *slist=NULL;
|
2003-02-21 10:19:50 -05:00
|
|
|
|
|
|
|
|
slist = curl_slist_append(slist, "pragma:");
|
|
|
|
|
curl_easy_setopt(handle, CURLOPT_HTTPHEADER, slist);
|
|
|
|
|
|
|
|
|
|
curl_easy_perform(handle);
|
|
|
|
|
|
|
|
|
|
curl_slist_free_all(slist); /* free the list again */
|
2007-01-09 13:58:16 -05:00
|
|
|
.fi
|
2002-03-04 05:09:48 -05:00
|
|
|
.SH "SEE ALSO"
|
|
|
|
|
.BR curl_slist_free_all "(3), "
|
