引子

libcurl并没有提供一个直接的API用于构建URL编码的application/x-www-form-urlencoded表单/URL编码的路径，虽然也可以使用curl_easy_escape手动对application/x-www-form-urlencoded表单和路径的各个部分进行URL编码，但这样做太过复杂，好在libcurl的URL解析模块（curl_url_set、curl_url_get）能够间接达到效果。

构建URL编码的application/x-www-form-urlencoded表单

HTTP的POST方法常用application/x-www-form-urlencoded来发送数据，数据被编码成以 '&' 分隔的键值对，同时以'='分隔键和值。键和值中非字母或数字的字符会被URL编码。从application/x-www-form-urlencoded表单结构可知，这和URL参数几乎是一样的，因此可以使用curl_url_set来构建URL参数CURLUPART_QUERY从而间接构建application/x-www-form-urlencoded表单：

CURLUcode rc;
CURLU *url = curl_url();
char *form = NULL;
rc = curl_url_set(url, CURLUPART_QUERY, "id=test 2333", CURLU_APPENDQUERY | CURLU_URLENCODE);
rc = curl_url_set(url, CURLUPART_QUERY, "time=22:36", CURLU_APPENDQUERY | CURLU_URLENCODE);
rc = curl_url_set(url, CURLUPART_QUERY, "q=name=test", CURLU_APPENDQUERY | CURLU_URLENCODE);
rc = curl_url_get(url, CURLUPART_QUERY, &form, 0);
printf("form: %s\n", form);
curl_free(form);
curl_url_cleanup(url);

输出为：

form: id=test+2333&time=22%3a36&q=name%3dtest

CURLU_APPENDQUERY将在已有的参数队列的尾部添加键值对，并且和CURLU_URLENCODE一起使用时会将对第一个=外的所有字符进行URL编码。需要额外注意，用于构建的CURLU和curl_url_get获取的参数使用完成后需要分别使用curl_url_cleanup、curl_free释放。

构建URL编码路径

对于路径的URL编码通常需要只保留/并编码其他部分，同样也可以设置CURLU的CURLUPART_PATH的部分即可实现：

CURLUcode rc;
CURLU *url = curl_url();
char *path = NULL;
rc = curl_url_set(url, CURLUPART_PATH, "/Program Files (x86)/test", CURLU_URLENCODE);
rc = curl_url_get(url, CURLUPART_PATH, &path, 0);
printf("path: %s\n", path);
curl_free(path);
curl_url_cleanup(url);

输出为：

path: /Program%20Files%20%28x86%29/test