URL 接口的使用
这个文档是小编在curl官网上使用谷歌翻译翻译的，详细信息看官网
curl
描述
URL 接口提供解析和生成 URL 的功能。
包括
您仍然只在代码中包含
创造
使用curl_url创建一个包含 URL 信息和资源的句柄：
CURLU *h = curl_url();
清理
完成后，使用curl_url_cleanup进行清理：
curl_url_cleanup(h);
复制
当您需要句柄的副本时，只需使用curl_url_dup复制它：
CURLU *nh = curl_url_dup(h);
解析
通过使用curl_url_set将 URL “设置”到句柄，URL 被解析并存储在句柄中。如果 URL 在语法上不正确，它将返回错误。
rc = curl_url_set(h, CURLUPART_URL, "https://example.com:449/foo/bar?name=moo", 0);
第四个参数中的零是用于更改特定功能的位掩码。
如果成功，这会将 URL 存储在句柄内的各个部分中。
重定向
当句柄已经包含有关 URL 的信息时，设置相对 URL 将使其“重定向”以适应它。
rc = curl_url_set(h, CURLUPART_URL, "../test?another", 0);
获取网址
`CURLU` 句柄代表一个 URL，您可以使用curl_url_get轻松提取它：
字符 *url; rc = curl_url_get(h, CURLUPART_URL, &url, 0); curl_free(url);
第四个参数中的零是用于更改特定功能的位掩码。
获取零件
解析 URL 或设置部分后，您可以随时从句柄中提取这些部分。
rc = curl_url_get(h, CURLUPART_HOST, &host, 0);
rc = curl_url_get(h, CURLUPART_SCHEME, &scheme, 0);
rc = curl_url_get(h, CURLUPART_USER, &user, 0);
rc = curl_url_get(h, CURLUPART_PASSWORD, &password, 0);
rc = curl_url_get(h, CURLUPART_PORT, &port, 0);
rc = curl_url_get(h, CURLUPART_PATH, &path, 0);
rc = curl_url_get(h, CURLUPART_QUERY, &query, 0);
rc = curl_url_get(h, CURLUPART_FRAGMENT, &fragment, 0);
除非用户在第四个位掩码参数中设置了 CURLU_URLDECODE 标志，否则不会对提取的部分进行 URL 解码。
完成后记得使用curl_free释放返回的字符串！
设置零件
用户设置单独的 URL 部分，或者在解析完整的 URL 之后，或者没有解析这样的部分。
rc = curl_url_set(urlp, CURLUPART_HOST, "www.example.com", 0);
rc = curl_url_set(urlp, CURLUPART_SCHEME, "https", 0);
rc = curl_url_set(urlp, CURLUPART_USER, "约翰", 0);
rc = curl_url_set(urlp, CURLUPART_PASSWORD, "doe", 0);
rc = curl_url_set(urlp, CURLUPART_PORT, "443", 0);
rc = curl_url_set(urlp, CURLUPART_PATH, "/index.html", 0);
rc = curl_url_set(urlp, CURLUPART_QUERY, "name=john", 0);
rc = curl_url_set(urlp, CURLUPART_FRAGMENT, "锚点", 0);
除非用户使用 `CURLU_URLENCODE` 标志请求它，否则集合部分不是 URL 编码的。
追加查询
应用程序可以将字符串附加到查询部分的右端，并将 `CURLU_APPENDQUERY` 标志添加到curl_url_set。
想象一个持有 URL https://example.com/?shoes=2 的句柄。然后应用程序可以将字符串 `hat=1` 添加到查询部分，如下所示：
rc = curl_url_set(urlp, CURLUPART_QUERY, "hat=1", CURLU_APPENDQUERY);
它甚至会注意到缺少与号（&）分隔符，因此它也会注入一个，并且句柄的完整 URL 将等于https://example.com/?shoes=2&hat=1。
附加的字符串当然也可以在添加时获得 URL 编码，如果被要求进行 URL 编码，编码过程将跳过“=”字符。例如，将 `candy=N&N` 附加到我们已有的内容中，并对其进行 URL 编码以处理数据中的 & 符号：
rc = curl_url_set(urlp, CURLUPART_QUERY, "candy=N&N", CURLU_APPENDQUERY | CURLU_URLENCODE);
现在 URL 看起来像
https://example.com/?shoes=2&hat=1&candy=N%26N`
可用性
URL API 是在 libcurl 7.62.0 中引入的。