使用libcurl步骤5之curl_easy_cleanup

文章采集自互联网,仅做学习笔记使用

curl_easy_cleanup - 结束一个libcurl简易句柄

名称

curl_easy_cleanup - 结束一个libcurl简易句柄

概要

#include

void curl_easy_cleanup（CURL * handle）;

描述

此函数必须是调用简易会话的最后一个函数。它与curl_easy_init函数相反，必须使用与curl_easy_init调用返回的输入相同的句柄调用。

这可能会关闭此句柄已使用的所有连接，并且可能一直保持打开状态 - 除非在执行传输时将其连接到多个句柄。如果您打算传输更多文件，请不要调用此函数，重用句柄是libcurl良好性能的关键。

有时，您可能会从curl_easy_cleanup中调用进程回调或标头回调（如果之前使用curl_easy_setopt为句柄设置）。就像libcurl决定关闭连接一样，协议是一种在断开连接之前需要命令/响应序列的协议。此类协议的示例是FTP，POP3和IMAP。

调用此函数并返回后对句柄的任何使用都是非法的。curl_easy_cleanup杀死句柄和与之关联的所有内存！

传入句柄中的NULL指针将使该函数立即返回而不执行任何操作。

旧时代

对于7.17之前的libcurl版本，在你调用此函数之后，你可以安全地删除你之前告诉libcurl使用的所有字符串，因为它现在不再使用它们了。

返回值

没有

例

 

CURL * curl = curl_easy_init（）;
if（curl）{
  CURLcode res;
  curl_easy_setopt（curl，CURLOPT_URL，“http://example.com”）;
  res = curl_easy_perform（curl）;
  curl_easy_cleanup（卷曲）;
}

使用libcurl步骤1之curl_global_init

使用libcurl步骤2之curl_easy_init

使用libcurl步骤3之curl_easy_setopt

使用libcurl步骤4之curl_easy_perform

使用libcurl步骤5之curl_easy_cleanup