mirror of https://github.com/moparisthebest/curl
Mention first version with CURLOPT_COPYPOSTFIELDS.
Don't confuse NUL with NULL.
This commit is contained in:
parent
add90abfa4
commit
a83b5d1b67
|
@ -28,7 +28,7 @@ ares_expand_string \- Expand a length encoded string
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
The
|
The
|
||||||
.B ares_expand_string
|
.B ares_expand_string
|
||||||
function converts a length encoded string to a NULL terminated C
|
function converts a length encoded string to a NUL-terminated C
|
||||||
string. The argument
|
string. The argument
|
||||||
.I encoded
|
.I encoded
|
||||||
gives the beginning of the encoded string, and the arguments
|
gives the beginning of the encoded string, and the arguments
|
||||||
|
|
|
@ -727,18 +727,19 @@ data to figure out the size. This is the large file version of the
|
||||||
\fICURLOPT_POSTFIELDSIZE\fP option. (Added in 7.11.1)
|
\fICURLOPT_POSTFIELDSIZE\fP option. (Added in 7.11.1)
|
||||||
.IP CURLOPT_COPYPOSTFIELDS
|
.IP CURLOPT_COPYPOSTFIELDS
|
||||||
Pass a char * as parameter, which should be the full data to post in an HTTP
|
Pass a char * as parameter, which should be the full data to post in an HTTP
|
||||||
POST operation. It behaves has the \fICURLOPT_POSTFIELDS\fP option, but the
|
POST operation. It behaves as the \fICURLOPT_POSTFIELDS\fP option, but the
|
||||||
original data are copied by the library, allowing the application to overwrite
|
original data are copied by the library, allowing the application to overwrite
|
||||||
the original data after setting this option.
|
the original data after setting this option.
|
||||||
|
|
||||||
Because data are copied, care must be taken when using this option in
|
Because data are copied, care must be taken when using this option in
|
||||||
conjunction with \fICURLOPT_POSTFIELDSIZE\fP or
|
conjunction with \fICURLOPT_POSTFIELDSIZE\fP or
|
||||||
\fICURLOPT_POSTFIELDSIZE_LARGE\fP: If the size has not been set prior to
|
\fICURLOPT_POSTFIELDSIZE_LARGE\fP: If the size has not been set prior to
|
||||||
\fICURLOPT_COPYPOSTFIELDS\fP, the data are assumed to be a null-terminated
|
\fICURLOPT_COPYPOSTFIELDS\fP, the data are assumed to be a NUL-terminated
|
||||||
string; else the stored size informs the library about the data byte count to
|
string; else the stored size informs the library about the data byte count to
|
||||||
copy. In any case, the size must not be changed after
|
copy. In any case, the size must not be changed after
|
||||||
\fICURLOPT_COPYPOSTFIELDS\fP, unless another \fICURLOPT_POSTFIELDS\fP or
|
\fICURLOPT_COPYPOSTFIELDS\fP, unless another \fICURLOPT_POSTFIELDS\fP or
|
||||||
\fICURLOPT_COPYPOSTFIELDS\fP option is issued.
|
\fICURLOPT_COPYPOSTFIELDS\fP option is issued.
|
||||||
|
(Added in 7.17.1)
|
||||||
|
|
||||||
.IP CURLOPT_HTTPPOST
|
.IP CURLOPT_HTTPPOST
|
||||||
Tells libcurl you want a multipart/formdata HTTP POST to be made and you
|
Tells libcurl you want a multipart/formdata HTTP POST to be made and you
|
||||||
|
|
|
@ -44,7 +44,7 @@ parts.
|
||||||
.IP CURLFORM_COPYNAME
|
.IP CURLFORM_COPYNAME
|
||||||
followed by a string which provides the \fIname\fP of this part. libcurl
|
followed by a string which provides the \fIname\fP of this part. libcurl
|
||||||
copies the string so your application doesn't need to keep it around after
|
copies the string so your application doesn't need to keep it around after
|
||||||
this function call. If the name isn't null terminated, or if you'd
|
this function call. If the name isn't NUL-terminated, or if you'd
|
||||||
like it to contain zero bytes, you must set its length with
|
like it to contain zero bytes, you must set its length with
|
||||||
\fBCURLFORM_NAMELENGTH\fP. The copied data will be freed by
|
\fBCURLFORM_NAMELENGTH\fP. The copied data will be freed by
|
||||||
\fIcurl_formfree(3)\fP.
|
\fIcurl_formfree(3)\fP.
|
||||||
|
@ -53,7 +53,7 @@ like it to contain zero bytes, you must set its length with
|
||||||
followed by a string which provides the \fIname\fP of this part. libcurl
|
followed by a string which provides the \fIname\fP of this part. libcurl
|
||||||
will use the pointer and refer to the data in your application, so you
|
will use the pointer and refer to the data in your application, so you
|
||||||
must make sure it remains until curl no longer needs it. If the name
|
must make sure it remains until curl no longer needs it. If the name
|
||||||
isn't null terminated, or if you'd like it to contain zero
|
isn't NUL-terminated, or if you'd like it to contain zero
|
||||||
bytes, you must set its length with \fBCURLFORM_NAMELENGTH\fP.
|
bytes, you must set its length with \fBCURLFORM_NAMELENGTH\fP.
|
||||||
|
|
||||||
.IP CURLFORM_COPYCONTENTS
|
.IP CURLFORM_COPYCONTENTS
|
||||||
|
@ -68,7 +68,7 @@ data will be freed by \fIcurl_formfree(3)\fP.
|
||||||
followed by a pointer to the contents of this part, the actual data
|
followed by a pointer to the contents of this part, the actual data
|
||||||
to send away. libcurl will use the pointer and refer to the data in your
|
to send away. libcurl will use the pointer and refer to the data in your
|
||||||
application, so you must make sure it remains until curl no longer needs it.
|
application, so you must make sure it remains until curl no longer needs it.
|
||||||
If the data isn't null terminated, or if you'd like it to contain zero bytes,
|
If the data isn't NUL-terminated, or if you'd like it to contain zero bytes,
|
||||||
you must set its length with \fBCURLFORM_CONTENTSLENGTH\fP.
|
you must set its length with \fBCURLFORM_CONTENTSLENGTH\fP.
|
||||||
|
|
||||||
.IP CURLFORM_CONTENTSLENGTH
|
.IP CURLFORM_CONTENTSLENGTH
|
||||||
|
|
Loading…
Reference in New Issue