curl使用笔记2——curl_easy_init()函数实现流程

easy.c源文件
curl_easy_init()

此函数必须是第一个要调用的函数，它返回一个CURL简易句柄，您必须将其用作easy界面中其他函数的输入。操作完成后，此调用必须对curl_easy_cleanup进行相应的调用。

如果您还没有调用curl_global_init，curl_easy_init会自动执行此操作。这在多线程情况下可能是致命的，因为curl_global_init不是线程安全的，并且可能导致资源问题，因为没有相应的清理。

强烈建议您通过正确调用curl_global_init来禁止此自动行为。有关如何使用此函数的详细信息，请参阅libcurl（3）中有关全局环境要求的说明。

一般curl_easy_init意味着一个会话的开始. 它会返回一个easy_handle(CURL*对象), 一般都用在easy系列的函数中.

 

源码里定义是
struct Curl_easy *curl_easy_init(void)
返回的是struct Curl_easy类型的结构体，但我们在使用的过程中发现
CURL *curlHandle = curl_easy_init(); 返回的是CURL *类型的指针变量。
为什么呢？
在curl.h头文件中 BUILDING_LIBCURL这个宏在项目设置里有配置，路径如下：项目属性-》配置属性-》C/C++-》预处理理器-》预处理器定义里第二个参数
#if defined(BUILDING_LIBCURL) || defined(CURL_STRICTER)
typedef struct Curl_easy CURL;
typedef struct Curl_share CURLSH;
#else
typedef void CURL;
typedef void CURLSH;
#endif

编译库的时候，把struct Curl_easy定义成CURL类型了。

而在使用的过程中 CURL就是void类型

static unsigned int  initialized;   //static的用法

静态全局变量有以下特点：
1.该变量在全局数据区分配内存；
2.未经初始化的静态全局变量会被程序自动初始化为0（ 在函数体内声明的自动变量的值是随机的，除非它被显式初始化，而在函数体外被声明的自动变量也会被初始化为0）；
3.静态全局变量在声明它的整个文件都是可见的，而在文件之外是不可见的；
4.静态变量都在全局数据区分配内存，包括后面将要提到的静态局部变量。

struct Curl_easy *curl_easy_init(void)
{
  CURLcode result;
  struct Curl_easy *data;
 
  /* Make sure we inited the global SSL stuff */
  if(!initialized) //initialized在easy.c源文件的第88行定义成静态全局变量，默认初始化为0；
  {
    result = curl_global_init(CURL_GLOBAL_DEFAULT);
    if(result)
    {
      /* something in the global init failed, return nothing */
      DEBUGF(fprintf(stderr, "Error: curl_global_init failed\n"));
      return NULL;
    }
  }

  /* We use curl_open() with undefined URL so far */
  result = Curl_open(&data);
  if(result) {
    DEBUGF(fprintf(stderr, "Error: Curl_open failed\n"));
    return NULL;
  }

  return data;
}

curl_easy_init流程：

struct Curl_easy *curl_easy_init(void) // easy.c文件
	curl_global_init(CURL_GLOBAL_DEFAULT); 如果这个函数已经初始化，直接返回
	Curl_open(struct Curl_easy **curl);//打开curl初始对应的参数 url.c文件
	//初始化解析器 resolver是一个UrlState 结构体，在asyn-thread.c文件中分配空间
	Curl_resolver_init(struct Curl_easy *easy, void **resolver);
		*resolver = calloc(1, sizeof(struct resdata));//calloc申请空间并初始化为0 malloc申请空间并不会初始化
	//初始化用户定义的数据
	Curl_init_userdefined(data);//url.c文件
		struct UserDefined *set = &data->set;// UserDefined是一个结构体，里面有很多参数
		Curl_mime_initpart(curl_mimepart *part, struct Curl_easy *easy);//初始化一个mine部分 mime.c文件
		Curl_ssl_backend(void); //vtls.c文件
		multissl_init(const struct Curl_ssl *backend)
	Curl_convert_init(data);
	//初始化统计和信息数据，对Progress和PureInfo两个结构体的字段数据进行初始化
    Curl_initinfo(data);//getinfo.c文件

 

return data;