初学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
- 解压文件。
- 通过命令行进入到curl-7.32.0目录下。
- 键入 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,非零值表示出现错误。
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);
暂停或者启动一个连接。
一个连接可以同过调用这个函数或者让读或写操作的回调函数返回 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。
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 );
释放内存。