moparisthebest
/
curl
mirror of https://github.com/moparisthebest/curl
1
0
Fork 0
Code Issues Releases Wiki Activity

curl_slist_append.3: clarify a NULL input creates a new list

This commit is contained in:
Daniel Stenberg 2017-05-05 13:54:32 +02:00
parent ad8c1472fe
commit 9b47f67929
1 changed files with 14 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
docs/libcurl/curl_slist_append.3
View File

@ -5,7 +5,7 @@
.\" * | (__| |_| | _ <| |___ .\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____| .\" * \___|\___/|_| \_\_____|
.\" * .\" *
.\" * Copyright (C) 1998 - 2016, Daniel Stenberg, <daniel@haxx.se>, et al. .\" * Copyright (C) 1998 - 2017, Daniel Stenberg, <daniel@haxx.se>, et al.
.\" * .\" *
.\" * This software is licensed as described in the file COPYING, which .\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms .\" * you should have received as part of this distribution. The terms
@ -29,11 +29,11 @@ curl_slist_append - add a string to an slist
.BI "const char * "string ");" .BI "const char * "string ");"
.ad .ad
.SH DESCRIPTION .SH DESCRIPTION
curl_slist_append() appends a specified string to a linked list of \fIcurl_slist_append(3)\fP appends a string to a linked list of strings. The
strings. The existing \fIlist\fP should be passed as the first argument while existing \fBlist\fP should be passed as the first argument and the new list is
the new list is returned from this function. The specified \fIstring\fP has returned from this function. Pass in NULL in the \fBlist\fP argument to create
been appended when this function returns. curl_slist_append() copies the a new list. The specified \fBstring\fP has been appended when this function
string. returns. \fIcurl_slist_append(3)\fP copies the string.
The list should be freed again (after usage) with The list should be freed again (after usage) with
\fIcurl_slist_free_all(3)\fP. \fIcurl_slist_free_all(3)\fP.
@ -42,19 +42,19 @@ A null pointer is returned if anything went wrong, otherwise the new list
pointer is returned. pointer is returned.
.SH EXAMPLE .SH EXAMPLE
.nf .nf
CURL handle; CURL *handle;
struct curl_slist *slist=NULL; struct curl_slist *slist=NULL;
slist = curl_slist_append(slist, "pragma:"); slist = curl_slist_append(slist, "pragma:");
if (slist == NULL) if (slist == NULL)
return -1; return -1;
curl_easy_setopt(handle, CURLOPT_HTTPHEADER, slist); curl_easy_setopt(handle, CURLOPT_HTTPHEADER, slist);
curl_easy_perform(handle); curl_easy_perform(handle);
curl_slist_free_all(slist); /* free the list again */ curl_slist_free_all(slist); /* free the list again */
.fi .fi
.SH "SEE ALSO" .SH "SEE ALSO"
.BR curl_slist_free_all "(3), " .BR curl_slist_free_all "(3), "