转载自:http://blog.chinaunix.net/uid-20692625-id-3203258.html
一、常用函数
1、libcurl的全局初始化及释放:
CURLcode curl_global_init(long flags)
flags: CURL_GLOBAL_ALL //初始化所有的可能的调用。
CURL_GLOBAL_SSL //初始化支持 安全套接字层。
CURL_GLOBAL_WIN32 //初始化win32套接字库。
CURL_GLOBAL_NOTHING //没有额外的初始化。
void curl_global_cleanup(void)
在程序开始时调用初始化函数,虽然不调用这个初始化函数,libcurl会在curl_easy_init()函数中自动调用,但在多线程处理时,可能会出现多次自动调用的情况。
2、初始化下载handle及释放
CURL* curl = curl_easy_init();
curl_easy_cleanup(curl);
3、设置下载属性及常用参数
Curlicued curl_easy_setopt(CURL* handle,CURLoption option, parameter);
1)设置下载数据的回调函数:option:
CURLOPT_WRITEFUNCTION:设置回调函数
回调函数原型为:size_t function(void *ptr, size_t size, size_t nmemb, void *userp);
函数在libcurl接收到数据后被调用
参数1:ptr是下载回来的数据
参数2:size_t每次读取的字节数
参数3:读取的次数
参数4:用户指针,用户通过这个指针传输自己的数据
CURLOPT_WRITEDATA:设置回调函数中的void* userp指针来源
2)下载进度控制:
CURLOPT_NOPROGRESS:为了使CURLOPT_PROGRESSFUNCTION被调用,CURLOPT_NOPROGRESS必须设置为false;
CURLOPT_PROGRESSDATA:指定的函数正常情况下每秒被libcurl调用一次
CURLOPT_PROGRESSDATA:指定的参数将作为CURLOPT_PROGRESSFUNCTION指定函数的参数。
整个处理与下载数据回调的处理相同。
3)其它属性
CURLOPT_URL:设置访问的URL
CURLOPT_NOSIGNAL:屏蔽其他信号
CURLOPT_HEADER:取数据时连同HTTP头部一起取回
CURLOPT_HEADERFUNCTION与CURLOPT_HEADERDATA:只取HTTP头部数据,处理与下载数据回调的处理相同
CURLOPT_TIMEOUT:超时时间
CURLOPT_CONNECTIONTIMEOUT:连接等待时间
CURLOPT_FOLLOWLOCATION:支持302重定向
CURLOPT_RANGE:断点续传,指定传输分片,格式“0-200”
4)开始下载:
CURLcode curl_easy_perform(CURL* handle);
4、例子
获取网站包括HTTP头部信息在内的500字节数据
size_t callback_get_head(void *ptr, size_t size, size_t nmemb, void *userp)
{
strcat( userp, ptr);
return size * nmemb; //必须返回这个大小, 否则只回调一次, 不清楚为何.
}
void *get_head_thread(void *)
{
CURL *curl = curl_easy_init();
curl_easy_setopt(curl, CURLOPT_URL, "www.163.com"); //设置下载的URI
curl_easy_setopt(curl, CURLOPT_TIMEOUT, 20); //设置超时
curl_easy_setopt(curl, CURLOPT_NOSIGNAL, 1); //屏蔽其它信号
curl_easy_setopt(curl, CURLOPT_HEADER, 1); //下载数据包括HTTP头部
curl_easy_setopt(curl, CURLOPT_RANGE, "0-500"); //用于断点续传, 设置下载的分片
char buffer[MAXHEADLEN] = {0x0};
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, callback_get_head); //设置下载数据的回调函数
curl_easy_setopt(curl, CURLOPT_WRITEDATA, buffer); //设置回调函数userp指针来源
curl_easy_perform(curl);
curl_easy_cleanup(curl);
//此时网站HTTP头信息已经存放在buffer内.
}
说明:void* get_head_thread(void *),这个函数内部的libcurl操作可以放到多线程中进行处理,唯一需要注意的是lib curl的全局初始化必须放在线程之外。