diff options
Diffstat (limited to 'docs/libcurl/curl_url_set.3')
-rw-r--r-- | docs/libcurl/curl_url_set.3 | 29 |
1 files changed, 15 insertions, 14 deletions
diff --git a/docs/libcurl/curl_url_set.3 b/docs/libcurl/curl_url_set.3 index 732802536..3c63913bf 100644 --- a/docs/libcurl/curl_url_set.3 +++ b/docs/libcurl/curl_url_set.3 @@ -19,7 +19,7 @@ .\" * KIND, either express or implied. .\" * .\" ************************************************************************** -.TH curl_url_set 3 "May 31, 2021" "libcurl 7.78.0" "libcurl Manual" +.TH curl_url_set 3 "October 31, 2021" "libcurl 7.80.0" "libcurl Manual" .SH NAME curl_url_set - set a URL part @@ -81,7 +81,7 @@ The query part will also get spaces converted to pluses when asked to URL encode on set with the CURLU_URLENCODE bit. If used together with the \fICURLU_APPENDQUERY\fP bit, the provided part will -be appended on the end of the existing query - and if the previous part didn't +be appended on the end of the existing query - and if the previous part did not end with an ampersand (&), an ampersand will be inserted before the new appended part. @@ -123,7 +123,7 @@ cannot know whether this is permitted for custom schemes. Specifying the flag permits empty authority sections, similar to how file scheme is handled. .IP CURLU_PATH_AS_IS When set for \fBCURLUPART_URL\fP, this makes libcurl skip the normalization of -the path. That's the procedure where curl otherwise removes sequences of +the path. That is the procedure where curl otherwise removes sequences of dot-slash and dot-dot etc. The same option used for transfers is called \fICURLOPT_PATH_AS_IS(3)\fP. .IP CURLU_ALLOW_SPACE @@ -135,15 +135,6 @@ When space is used and allowed in a URL, it will be stored as-is unless space before stored. This affects how the URL will be constructed when \fIcurl_url_get(3)\fP is subsequently used to extract the full URL or individual parts. -.SH RETURN VALUE -Returns a CURLUcode error value, which is CURLUE_OK (0) if everything went -fine. - -A URL string passed on to \fIcurl_url_set(3)\fP for the \fBCURLUPART_URL\fP -part, must be shorter than 8000000 bytes otherwise it returns -\fBCURLUE_MALFORMED_INPUT\fP (added in 7.65.0). - -If this function returns an error, no URL part is set. .SH EXAMPLE .nf CURLUcode rc; @@ -157,7 +148,17 @@ If this function returns an error, no URL part is set. curl_url_cleanup(url); .fi .SH AVAILABILITY -Added in curl 7.62.0. CURLUPART_ZONEID was added in 7.65.0. +Added in 7.62.0. CURLUPART_ZONEID was added in 7.65.0. +.SH RETURN VALUE +Returns a CURLUcode error value, which is CURLUE_OK (0) if everything went +fine. See the \fIlibcurl-errors(3)\fP man page for the full list with +descriptions. + +A URL string passed on to \fIcurl_url_set(3)\fP for the \fBCURLUPART_URL\fP +part, must be shorter than 8000000 bytes otherwise it returns +\fBCURLUE_MALFORMED_INPUT\fP (added in 7.65.0). + +If this function returns an error, no URL part is set. .SH "SEE ALSO" .BR curl_url_cleanup "(3), " curl_url "(3), " curl_url_get "(3), " -.BR curl_url_dup "(3), " CURLOPT_CURLU "(3), " +.BR curl_url_dup "(3), " curl_url_strerror "(3), " CURLOPT_CURLU "(3)" |