curl 库 curl_easy_setopt - 设置选项

名字

https://curl.se/libcurl/c/curl_easy_setopt.html

curl_easy_setopt - 设置选项

概要

#include <curl/curl.h>
 
CURLcode curl_easy_setopt(CURL *handle, CURLoption option, parameter);

描述

curl_easy_setopt用于告诉利布尔如何表现。通过设置适当的选项，应用程序可以更改 libcurl 的行为。所有选项都设置有一个选项，后跟一个参数。该参数可以是长整型、函数指针、对象指针或curl_off_t，具体取决于特定选项的预期内容。请仔细阅读本手册，因为错误的输入值可能会导致 libcurl 表现不佳！在每个函数调用中只能设置一个选项。典型的应用程序在设置阶段使用许多curl_easy_setopt调用。

使用此函数调用设置的选项对于使用此句柄执行的所有即将进行的传输都有效。这些选项不会在传输之间以任何方式重置，因此，如果您希望后续传输具有不同选项，则必须在传输之间更改它们。您可以选择使用curl_easy_reset将所有选项重置回内部默认值。

作为“字符 *”参数传递给 libcurl 的字符串，由库复制;与指针参数关联的字符串存储可能会在curl_easy_setopt返回后被丢弃或重用。此规则的唯一例外是CURLOPT_POSTFIELDS，但是复制字符串CURLOPT_COPYPOSTFIELDS的替代方法具有一些您需要阅读的使用特征。此函数不接受长度超过 CURL_MAX_INPUT_LENGTH （8 MB） 的输入字符串。

设置选项的顺序无关紧要。