Lines Matching +full:set +full:- +full:url

21 .\" * SPDX-License-Identifier: curl
26 curl_url_get - extract a part from a URL
31 CURLUcode curl_url_get(CURLU *url,
37 Given the \fIurl\fP handle of an already parsed URL, this function lets the
44 The URL API has no particular maximum length for URL fiends. In the real
52 The flags argument is zero, one or more bits set in a bitmask.
63 Asks \fIcurl_url_get(3)\fP to URL decode the contents before returning it. It
64 will not attempt to decode the scheme, the port number or the full URL.
66 The query component will also get plus-to-space conversion as a bonus when
67 this bit is set.
69 Note that this URL decoding is charset unaware and you will get a zero
76 If set, will make \fIcurl_url_get(3)\fP URL encode the host name part when a
77 full URL is retrieved. If not set (default), libcurl returns the URL with the
78 host name "raw" to support IDN names to appear as-is. IDN host names are
79 typically using non-ASCII bytes that otherwise will be percent-encoded.
81 Note that even when not asking for URL encoding, the '%' (byte 37) will be URL
84 If set and \fICURLU_URLENCODE\fP is not set, and asked to retrieve the
86 name in its punycode version if it contains any non-ASCII octets (and is an
96 When asked to return the full URL, \fIcurl_url_get(3)\fP will return a
99 We advise using the \fICURLU_PUNYCODE\fP option to get the URL as "normalized"
103 Scheme cannot be URL decoded on get.
109 schemes: pop3, smtp and imap. The URL API still allows users to set and get
116 IPv6 names are normalized when set, which should make them as short as
119 If the host name is a numeric IPv6 address, this field might also be set.
121 A port cannot be URL decoded on get. This number is returned in a string just
125 The \fIpart\fP will be '/' even if no path is supplied in the URL. A URL path
131 A not-present query will lead \fIpart\fP to be set to NULL.
132 A zero-length query will lead \fIpart\fP to be set to a zero-length string.
134 The query part will also get pluses converted to space when asked to URL
142   CURLU *url = curl_url();
143   rc = curl_url_set(url, CURLUPART_URL, "https://example.com", 0);
146     rc = curl_url_get(url, CURLUPART_SCHEME, &scheme, 0);
151     curl_url_cleanup(url);
158 fine. See the \fIlibcurl-errors(3)\fP man page for the full list with
161 If this function returns an error, no URL part is returned.