初学libcurl

最近想把某网站上的些数据download下来,在网上找到了cURL,正好来边学边弄一下!

  

下载libcurl源代码


cURL的官网是http://curl.haxx.se/ ,直接下载源代码包来编译吧 ,在download里面有源代码下在,最新版是curl-7.32.0(http://curl.haxx.se/download/curl-7.32.0.tar.gz)。

 

MinGw下编译libcurl


  1. 解压文件。
  2. 通过命令行进入到curl-7.32.0目录下。
  3. 键入 mingw32-make mingw32 编译生成。

libcurl的使用


libcurl是开源的url传输库,支持 FTP、HTTP等协议。我用C语言来实现。curl的接口有很多,目前libcurl-easy接口的功能就足够强大,够完成我的要求了,所以这里就研究下libcurl-easy里的函数就行了,其他的以后用到在研究。

一般curl的使用流程:

1 curl_easy_init();        //初始化curl对象
2 curl_easy_setopt();        //设置curl对象的行为
3 curl_easy_perform();        //执行操作
4 curl_easy_cleanu p();        //关闭curl        

<culr/curl.h>中的部分函数:

1、 CURLcode curl_global_init(long flags);

该函数必须在调用其他curl函数之前调用。只需调用一次,调用多次和一次一样。

该函数是非线程安全的,所以不可以在它运行时,在其他线程调用它。

如果在使用curl_easy_init()函数之前未调用curl_global_init()函数,程序将自动调用。

参数:

CURL_GLOBAL_ALL   初始化除CURL_GLOBAL_ACK_EINTR外的所有系统。

CURL_GLOBAL_SSL   初始化SSL

CURL_GLOBAL_WIN32   初始化Win32 socket libraries.

CURL_GLOBAL_NOTHING   不初始化任何系统

CURL_GLOBAL_DEFAULT   等同于CURL_GLOBAL_ALL 

CURL_GLOBAL_ACK_EINTR   设置了这个标签后,当curl在连接或等待数据请求时,curl将接收EINTR条件,否则,curl会一直等待。

返回值:

正常通过时返回0,非零值表示出现错误。

 

2void curl_global_cleanup(void);

该函数释放由curl_global_init()函数请求的资源。

该函数必须在curl_global_init()函数之后调用,关闭curl库之前必须调用。

该函数也是非线程安全的。

 

3、CURL *curl_easy_init( );

该函数初始化生成一个curl的指针,该指针用做其他easy函数的输入。

该函数必须和curl_easy_clean()函数一起使用。

如果在调用该函数之前,你没有调用curl_global_init()进行初始化,系统将会自动调用curl_global_init()函数。

但建议你最好不用让系统自动调用该函数,因为可能会忘了调用curl_global_cleanup(),而出现问题。

所以最好手动调用curl_global_init()函数。

返回值:

返回一类似FILE的指针,如果返回NULL,则发生错误。

 

4void curl_easy_cleanup(CURL * handle );

调用该函数来结束一个curl easy会话。关闭一个由curl_easy_init()生成的handle

 

5、CURLcode curl_easy_setopt(CURL *handle, CURLoption option, parameter);

 为“easy”句柄设置一个行为。

curl_easy_setopt()函数告诉libcurl该如何做。通过设置适当的参数,你可以改变libcurl的行为。

基本所有的操作都是通过这个函数设置的。

option参数是一系列的行为操作。

parameter取决于option参数的设置。

返回值:

0或CURL_OK表示成功。非零值表示有错误发生。

如果你设置了一个libcurl无法识别的行为,可能是libcurl版本过低,则将会返回 CURLE_FAILED_INIT。

 

6、CURLcode curl_easy_perform(CURL * handle);

 执行会话的操作。

该函数在curl_easy_init()函数和所有的curl_easy_setopt()函数设置完后调用,执行所有设置的操作。

返回值:

成功则返回0,返回non-zero则失败。如果在curl_easy_setopt()函数中设置了 CURLOPT_ERRORBUFFER ,则当返回non-zero时,在error buffer中会有可读的错误信息。

 

7、CURL *curl_easy_duphandle(CURL *handle);

 克隆一个curl会话句柄。

该函数将返回一个curl副本,拥有之前句柄的所有设置。

新的curl句柄也必须在关闭时调用curl_easy_cleanup()函数。

新生成的副本不会继承任何状态信息,没有连接,没有SSL,没有cookies。

返回值:

如果返回NULL,则表示克隆失败。

 

8char *curl_easy_escape( CURL * curl , char * url , int length);

 URL编码给定的字符串。

该程序将输入的字符串转化为一个URL编码字符串,返回一个新生成的字符串。

除了a-z, A-Z, 0-9, '-', '.', '_' or '~'字符外,其他字符都转为转义字符形式。

如果length参数设为0,将自动调用strlen()函数计算url的长度作为参数。

必须用curl_free()函数来释放字符串内存。

返回值:

一个指向字符串结尾的指针或者NULL表示转化失败。

 

9char *curl_easy_unescape( CURL * curl , char * url , int inlength , int * outlength);

 URL解码给定的字符串。

所有输入的URL编码都转化成他们相对应的二进制码。

如果inlength参数设为0,将自动调用strlen()函数计算url的长度作为参数。

如果outlength参数为non-NULL,函数将写入返回字符串的长度。

返回值:

一个指向字符串结尾的指针或者NULL表示转化失败。

 

10、CURLcode curl_easy_getinfo(CURL *curl, CURLINFO info, ...);

 用来获取curl句柄的信息。

 

11、CURLcode curl_easy_pause(CURL *handle , int bitmask);

 暂停或者启动一个连接。

一个连接可以同过调用这个函数或者让读或写操作的回调函数返回 CURL_READFUNC_PAUSE 或 CURL_WRITEFUNC_PAUSE 来暂停连接。

handle参数指向要暂停的会话。

bitmask参数设置了连接的新状态。如下可选:

CURLPAUSE_RECV

停止接收数据。该会话将不会在接收数据,直到再次调用没有改位状态的该函数。

CURLPAUSE_SEND

停止发送数据。该会话将不会在发送数据,直到再次调用没有改位状态的该函数。

CURLPAUSE_ALL

停止会话的发送和接收。

CURLPAUSE_CONT

重启会话的发送和接收。

 

12、CURLcode curl_easy_recv( CURL * curl , void * buffer , size_t buflen , size_t * n);

 通过一个"easy"连接接收数据。

该函数通过建立的连接接收数据。可以和curl_easy_send()函数一起使用,通过libcurl库实现自定义的协议。

buffer指向你要存储接收到的数据的地址。buflen是你可以从缓存中获取的数据的最大值,n将接收你所接收的数据的长度。

如果通过设置 CURLOPT_CONNECT_ONLY 建立起连接,curl_easy_recv()函数将无法调用。

在调用curl_easy_recv()函数之前,必须确定socket有数据可读,否则将会返回 CURLE_AGAIN 。

通过调用curl_easy_getinfo()函数,并设置参数为 CURLINFO_LASTSOCKET 来获取socket。

可通过系统工具 select() 检查是否有数据可读。

返回值:

如果成功,则返回 CURLE_OK,获得的数据将存入buffer中,而数据的大小将存入n中。

如果失败,返回占用错误代码。

如果没有数据可读,将返回 CURLE_AGAIN 。

如果没有可用的socket,将返回 CURLE_UNSUPPORTED_PROTOCOL。

 

13、CURLcode curl_easy_send( CURL * curl , const void * buffer , size_t buflen , size_t * n);

 通过一个"easy"连接发送数据。

该函数通过建立的连接发送任意数据。可以和curl_easy_recv()函数一起使用,通过libcurl库实现自定义的协议。

buffer指向你要发送的数据的地址。buflen是发送的数据的长度,n将接收你所发送的数据的长度。

如果通过设置 CURLOPT_CONNECT_ONLY 建立起连接,curl_easy_recv()函数将无法调用。

在调用curl_easy_send()函数之前,必须确定socket有数据可读,否则将会返回 CURLE_AGAIN 。

通过调用curl_easy_getinfo()函数,并设置参数为 CURLINFO_LASTSOCKET 来获取socket。

可通过系统工具 select() 检查是否有数据可读。

返回值:

如果成功,则返回 CURLE_OK,实际发送的数据的大小将存入n中。

如果失败,返回占用错误代码。

如果没有可用的socket,将返回 CURLE_UNSUPPORTED_PROTOCOL。

 

14void curl_easy_reset(CURL *handle);

 重设一个curl句柄。

重初始化一个curl句柄,使其和刚调用curl_easy_init()函数时一样。

无法改变句柄中的以下信息:活动中的连接,Session ID cache,DNS cache,cookies 和 share。

 

15const char *curl_easy_strerror(CURLcode errornum);

 该函数通过errornum参数,返回刚发生的错误信息的字符串。

 

16void curl_free( char * ptr );

释放内存。

 

posted on 2013-08-17 00:22  wing_h  阅读(4932)  评论(0编辑  收藏  举报