2 <title>curl_slist_append man page
</title>
3 <meta name=
"generator" content=
"roffit 0.7">
4 <STYLE type=
"text/css">
30 background-color: #e0e0e0;
36 font-family: monospace;
46 <p class=
"level0"><a name=
"NAME"></a><h2 class=
"nroffsh">NAME
</h2>
47 <p class=
"level0">curl_slist_append - add a string to an slist
<a name=
"SYNOPSIS"></a><h2 class=
"nroffsh">SYNOPSIS
</h2>
48 <p class=
"level0"><span Class=
"bold">#include
<curl/curl.h
></span>
49 <p class=
"level0"><span Class=
"bold">struct curl_slist *curl_slist_append(struct curl_slist * list,
</span> <span Class=
"bold">const char * string );
</span>
50 <p class=
"level0"><a name=
"DESCRIPTION"></a><h2 class=
"nroffsh">DESCRIPTION
</h2>
51 <p class=
"level0">curl_slist_append() appends a specified string to a linked list of strings. The existing
<span Class=
"emphasis">list
</span> should be passed as the first argument while the new list is returned from this function. The specified
<span Class=
"emphasis">string
</span> has been appended when this function returns. curl_slist_append() copies the string.
52 <p class=
"level0">The list should be freed again (after usage) with
<a class=
"bold" href=
"./curl_slist_free_all.html">curl_slist_free_all(
3)
</a>.
<a name=
"RETURN"></a><h2 class=
"nroffsh">RETURN VALUE
</h2>
53 <p class=
"level0">A null pointer is returned if anything went wrong, otherwise the new list pointer is returned.
<a name=
"EXAMPLE"></a><h2 class=
"nroffsh">EXAMPLE
</h2>
54 <p class=
"level0"><pre>
55 <p class=
"level0"> CURL handle;
56 struct curl_slist *slist=NULL;
57 <p class=
"level0"> slist = curl_slist_append(slist,
"pragma:");
58 curl_easy_setopt(handle, CURLOPT_HTTPHEADER, slist);
59 <p class=
"level0"> curl_easy_perform(handle);
60 <p class=
"level0"> curl_slist_free_all(slist); /* free the list again */
63 <p class=
"level0"><a name=
"SEE"></a><h2 class=
"nroffsh">SEE ALSO
</h2>
64 <p class=
"level0"><a class=
"manpage" href=
"./curl_slist_free_all.html">curl_slist_free_all (
3)
</a> <span Class=
"manpage"> </span> <p class=
"roffit">
65 This HTML page was made with
<a href=
"http://daniel.haxx.se/projects/roffit/">roffit
</a>.