名称 ​​curl_easy_cleanup​​

原型


#include <curl/curl.h>

void curl_easy_cleanup(CURL *handle);


描述


这个函数必须在整个easy会话的最后被调用，它正好和curl_easy_init相反。这个函数可能关闭和这个句柄相关的所有连接。如果你打算传输多个文件，请不要每次都调用这个函数，这个句柄打开以后，重复使用这个句柄传输所有文件，都传输完成以后，在调用这个函数，释放这个句柄。重复使用句柄是libcurl高性能使用的关键。

这个函数也可以在progress callback 或者header callback中调用，这样可以终止连接。

（句柄）handle被这个函数清理以后，在继续使用都是非法的。curl_easy_cleanup已经清理掉了这个句柄和这个句柄相关的所有内存。

如果这个函数输入的句柄是一个空指针，这个函数会立即返回。


示例

CURL *curl = curl_easy_init();
if(curl) {
  CURLcode res;
  curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
  res = curl_easy_perform(curl);
  curl_easy_cleanup(curl);
}