libcurl 使用及例程

- 日理万妓 2022-09-23 15:00 247阅读 0赞

原：http://blog.chinaunix.net/uid-20692625-id-3203258.html

前段时间写了个linux下的多线程下载工具, 使用到了强大的libcurl库. 现将libcurl的使用总结如下:

关于libcurl的文章网络上很多, 这里不再描述. 以下是如何使用libcurl的例子.

一、常用函数

1) libcurl的全局初始化及释放

1.       CURLcode curl\_global\_init(long flags)

flags: CURL\_GLOBAL\_ALL     //初始化所有的可能的调用。

CURL\_GLOBAL\_SSL     //初始化支持 安全套接字层。

CURL\_GLOBAL\_WIN32   //初始化win32套接字库。

CURL\_GLOBAL\_NOTHING //没有额外的初始化。

1.       void     curl\_global\_cleanup(void)

应该在程序开始时调用初始化函数. 虽然不调用这个初始化函数, libcurl会在curl\_easy\_init()函数中自动调用. 但在多线程处理时, 可能会出现多次自动调用的情况.

2) 初始化下载handle及释放

1.       CURL \*curl = curl\_easy\_init();  
    
2.       curl\_easy\_cleanup(curl);

3) 设置下载属性. 及常用参数.

1.       CURLcode curl\_easy\_setopt(CURL \*handle, CURLoption option, parameter);

1.   设置下载数据的回调函数.

1.       option:      
2.       CURLOPT\_WRITEFUNCTION //设置回调函数

回调函数原型为: size\_t  function (  void  \* ptr ,  size\_t size ,  size\_t nmemb ,  void  \* userp ) ;            函数将在libcurl 接收到数据后被调用 。

void \*ptr 是 下载回来的数据 .

void \* userp 是用户指针, 用户通过这个指针传输自己的数据.

1.       CURLOPT\_WRITEDATA   
    
2.  　　    设置回调函数中的void \*userp指针的来源。

2.  下载进度控制.

1.       option:
2.       CURLOPT\_NOPROGRESS  
3.         为了使CURLOPT\_PROGRESSFUNCTION被调用. CURLOPT\_NOPROGRESS必须被设置为false.
4.       CURLOPT\_PROGRESSFUNCTION
5.         CURLOPT\_PROGRESSFUNCTION 指定的函数正常情况下每秒被libcurl调用一次.
6.       CURLOPT\_PROGRESSDATA  
    
7.         CURLOPT\_PROGRESSDATA指定的参数将作为CURLOPT\_PROGRESSFUNCTION指定函数的参数. 
8.       整个处理与下载数据回调的处理相同. 
9.       3. 其它常用属性.   
         option:
10.      CURLOPT\_URL
11.        设置访问的URI.
12.      CURLOPT\_NOSIGNAL
13.        屏蔽其它信号.
14.      CURLOPT\_HEADER
15.        取数据时连同HTTP头部一起取回.
16.      CURLOPT\_HEADERFUNCTION
17.      CURLOPT\_HEADERDATA
18.        只取HTTP头部数据, 处理与下载数据回调的处理相同. 
19.      CURLOPT\_TIMEOUT
20.        超时时间.
21.      CURLOPT\_CONNECTIONTIMEOUT
22.        连接等待时间.
23.      CURLOPT\_FOLLOWLOCATION
24. 　　   设置支持302重定向
25. 　　 CURLOPT\_RANGE
26.     　 断点续传, 指定传输分片, 格式:"0-200"

4) 开始下载

1.       CURLcode curl\_easy\_perform(CURL \*handle);

二、例程

获取网站包括HTTP头部信息在内的500字节数据.

1.  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);        //屏蔽其它信号