初学libcurl(一)

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

  

下载libcurl源代码

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

MinGw下编译libcurl

libcurl的使用

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

一般curl的使用流程:

curl_easy_setopt();curl_easy_perform();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,非零值表示出现错误。

2、void 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,则发生错误。

4、void 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,则表示克隆失败。

8、char *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表示转化失败。

9、char *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);

暂停或者启动一个连接。

一个连接可以同过调用这个函数或者让读或写操作的回调函数返回

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。

14、void curl_easy_reset(CURL *handle);

重设一个curl句柄。

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

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

15、const char *curl_easy_strerror(CURLcode errornum);

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

16、void curl_free( char * ptr );

释放内存。

只有经历过地狱般的折磨,才有征服天堂的力量。

初学libcurl(一)

相关文章:

你感兴趣的文章:

标签云: