libcurl使用总结
工程设置:
第一步:下载最新版本的 curl,可以到 http://curl.haxx.se/download.html 下载。
第二步:编译源代码,生成可用于其他程序的 dll 文件和 lib 文件。(有已经生成好的)
第三步:工程附加头文件中添加D:\Program Files\libcurl\include
附加库目录中添加D:\Program Files\libcurl
.h文件中#include<curl/curl.h>
.h文件中#prama comment(lib,"libcurl.lib")
函数简要说明:
在基于LibCurl的程序里,主要采用callback function (回调函数)的形式完成传输任务,用户在启动传输前设置好各类参数和回调函数,当满足条件时libcurl将调用用户的回调函数实现特定功能。下面是利用libcurl完成传输任务的流程:
1. 调用curl_global_init()初始化libcurl
2. 调用 curl_easy_init()函数得到 easy interface型指针
3. 调用curl_easy_setopt设置传输选项
4. 根据curl_easy_setopt设置的传输选项,实现回调函数以完成用户特定任务
5. 调用curl_easy_perform()函数完成传输任务
6. 调用curl_easy_cleanup()释放内存
在整过过程中设置curl_easy_setopt()参数是最关键的,几乎所有的libcurl程序都要使用它。
常用函数语法描述:
1、CURLcode curl_global_init(long flags); //初始化libcurl
这个函数只能用一次。(其实在调用curl_global_cleanup 函数后仍然可再用)
如果这个函数在curl_easy_init函数调用时还没调用,它讲由libcurl库自动完成。
参数:flags
CURL_GLOBAL_SSL //初始化支持 安全套接字层。
CURL_GLOBAL_WIN32 //初始化win32套接字库。
CURL_GLOBAL_NOTHING //没有额外的初始化。
示例:
CURLcode code;
code=curl_global_init(CURL_GLOBAL_WIN32);
if(code!=CURL_OK)
{
cout<<"init failed"<<endl;
return;
}
2、CURL *curl_easy_init( ); //获取easy handle
CURL *easy_handle =curl_easy_init();
if(easy_handle==NULL)
{
cout<<"get handle failed!"<<endl;
return;
}
描述: 这个函数最重要了.几乎所有的curl 程序都要频繁的使用它.它告诉curl库.程序将有如何的行为. 比如要查看一个网页的html代码等.(这个函数有些像ioctl函数)参数:
b、 CURLOPT_URL //设置访问URL
curl_easy_setopt(easy handle,CURLOPT_URL,"http://baidu.com");
c、 CURLOPT_WRITEFUNCTION,CURLOPT_WRITEDATA //保存数据
回调函数原型为:size_t function( void *ptr, size_t size, size_t nmemb, void *stream); 函数将在libcurl接收到数据后被调用,因此函数多做数据保存的功能,如处理下载文件。CURLOPT_WRITEDATA 用于表明CURLOPT_WRITEFUNCTION函数中的stream指针的来源。
d、CURLOPT_HEADERFUNCTION,CURLOPT_HEADERDATA//这个...
回调函数原型为: size_t function( void *ptr, size_t size,size_t nmemb, void *stream); libcurl一旦接收到http 头部数据后将调用该函数。CURLOPT_WRITEDATA 传递指针给libcurl,该指针表明CURLOPT_HEADERFUNCTION 函数的stream指针的来源。
e、CURLOPT_READFUNCTION CURLOPT_READDATA //上传数据
libCurl需要读取数据传递给远程主机时将调用CURLOPT_READFUNCTION指定的函数,函数原型是:size_t function(void *ptr, size_t size, size_t nmemb,void *stream). CURLOPT_READDATA 表明CURLOPT_READFUNCTION函数原型中的stream指针来源。
f、. CURLOPT_NOPROGRESS,CURLOPT_PROGRESSFUNCTION,CURLOPT_PROGRESSDATA
跟数据传输进度相关的参数。CURLOPT_PROGRESSFUNCTION 指定的函数正常情况下每秒被libcurl调用一次,为了使CURLOPT_PROGRESSFUNCTION被调用,CURLOPT_NOPROGRESS必须被设置为false,CURLOPT_PROGRESSDATA指定的参数将作为CURLOPT_PROGRESSFUNCTION指定函数的第一个参数
g、 CURLOPT_TIMEOUT,CURLOPT_CONNECTIONTIMEOUT:
CURLOPT_TIMEOUT 由于设置传输时间,CURLOPT_CONNECTIONTIMEOUT 设置连接等待时间
h、 CURLOPT_FOLLOWLOCATION //设置重定位URL
i、CURLOPT_RANGE: CURLOPT_RESUME_FROM: //断点续传相关设置
CURLOPT_RANGE 指定char *参数传递给libcurl,用于指明http域的RANGE头域,例如:
表示头500个字节:bytes=0-499
表示第二个500字节:bytes=500-999
表示最后500个字节:bytes=-500
表示500字节以后的范围:bytes=500-
第一个和最后一个字节:bytes=0-0,-1
同时指定几个范围:bytes=500-600,601-999
CURLOPT_RESUME_FROM 传递一个long参数给libcurl,指定你希望开始传递的偏移量。
4、CURLcode curl_easy_perform(CURL *handle); //该函数完成curl_easy_setopt指定的所有选项
错误码说明:
5、void curl_global_cleanup(void);
描述:在结束libcurl使用的时候,用来对curl_global_init做的工作清理。类似于close的函数。
6、void curl_easy_cleanup(CURL *handle);
描述:这个调用用来结束一个会话.与curl_easy_init配合着用。
参数:CURL类型的指针。
使用示例:
参考链接: