基于cJSON及心知天气模块化实现获取城市气象信息(现在、未来) ...

V1.0 2024年6月14日 发布于博客园

目次

• 序言
  
  
  
  • 功能描述
    
  • 运行效果示范
    
  • 注意!
    
  
  
• 代码
  
  
  
  • weather_api.h
    
  • weather_api.c
    
  • demo.c
    
  • cJSON.h
    
  • cJSON.c
    
  
  
• 参考链接
  

序言

功能描述

用于请求心知天气的信息, 现在的信息, 未来n天的气象信息(免费版仅能3天).
使用域名通过TCP连接到心知天气服务器, 采用cJSON进行解析.
模块化实现, 可选择英文、中文;天数;城市;
运行效果示范

1. 天气服务器域名 api.seniverse.com 的IP地址是 116.62.81.138
3. 位置 ID: WS0E9D8WN298
4. 位置名称: 广州
5. 国家: CN
6. 位置: 广州,广州,广东,中国
7. 时区: Asia/Shanghai
8. 时区偏移: +08:00
9. 天气情况: 阴
10. 天气代码: 9
11. 温度: 26
12. 最后更新时间: 2024-06-14T20:52:05+08:00
15. 城市 ID:         WS0E9D8WN298
16. 城市名称:        广州
17. 国家:            CN
18. 具体位置:        广州,广州,广东,中国
19. 时区:            Asia/Shanghai
20. 时区偏移:        +08:00
22. 日期:                    2024-06-14
23. 白天天气现象文字:        小雨
24. 白天天气现象代码:        13
25. 夜间天气现象文字:        暴雨
26. 夜间天气现象代码:        16
27. 当天最高气温:    31
28. 当天最低气温:    26
29. 降水量：         19.53
30. 降水概率:        0.98
31. 风向文字:        西南
32. 风向角度:        225
33. 风速:            8.4
34. 风力等级:        2
35. 相对湿度:        91
37. 日期:                    2024-06-15
38. 白天天气现象文字:        暴雨
39. 白天天气现象代码:        16
40. 夜间天气现象文字:        中雨
41. 夜间天气现象代码:        14
42. 当天最高气温:    31
43. 当天最低气温:    26
44. 降水量：         28.09
45. 降水概率:        0.98
46. 风向文字:        南
47. 风向角度:        180
48. 风速:            23.4
49. 风力等级:        4
50. 相对湿度:        87
52. 日期:                    2024-06-16
53. 白天天气现象文字:        中雨
54. 白天天气现象代码:        14
55. 夜间天气现象文字:        雷阵雨
56. 夜间天气现象代码:        11
57. 当天最高气温:    32
58. 当天最低气温:    26
59. 降水量：         18.96
60. 降水概率:        0.97
61. 风向文字:        南
62. 风向角度:        180
63. 风速:            15.3
64. 风力等级:        3
65. 相对湿度:        87
66. 数据更新时间:    2024-06-14T08:00:00+08:00
69. 信阳气象信息
71. 位置 ID: WT9NG9P4ZDHG
72. 位置名称: 信阳
73. 国家: CN
74. 位置: 信阳,信阳,河南,中国
75. 时区: Asia/Shanghai
76. 时区偏移: +08:00
77. 天气情况: 晴
78. 天气代码: 1
79. 温度: 32
80. 最后更新时间: 2024-06-14T20:48:23+08:00
83. 城市 ID:         WT9NG9P4ZDHG
84. 城市名称:        信阳
85. 国家:            CN
86. 具体位置:        信阳,信阳,河南,中国
87. 时区:            Asia/Shanghai
88. 时区偏移:        +08:00
90. 日期:                    2024-06-14
91. 白天天气现象文字:        阴
92. 白天天气现象代码:        9
93. 夜间天气现象文字:        晴
94. 夜间天气现象代码:        1
95. 当天最高气温:    39
96. 当天最低气温:    25
97. 降水量：         0.00
98. 降水概率:        0.00
99. 风向文字:        东
100. 风向角度:        90
101. 风速:            23.4
102. 风力等级:        4
103. 相对湿度:        65
105. 日期:                    2024-06-15
106. 白天天气现象文字:        晴
107. 白天天气现象代码:        0
108. 夜间天气现象文字:        阴
109. 夜间天气现象代码:        9
110. 当天最高气温:    39
111. 当天最低气温:    27
112. 降水量：         0.00
113. 降水概率:        0.00
114. 风向文字:        北
115. 风向角度:        0
116. 风速:            8.4
117. 风力等级:        2
118. 相对湿度:        53
120. 日期:                    2024-06-16
121. 白天天气现象文字:        小雨
122. 白天天气现象代码:        13
123. 夜间天气现象文字:        阴
124. 夜间天气现象代码:        9
125. 当天最高气温:    35
126. 当天最低气温:    25
127. 降水量：         19.45
128. 降水概率:        0.99
129. 风向文字:        东北
130. 风向角度:        45
131. 风速:            3.0
132. 风力等级:        1
133. 相对湿度:        95
134. 数据更新时间:    2024-06-14T08:00:00+08:00

复制代码

注意!

在weather_api.h中必要填写自己的私钥
#define KEY "XXXXXXXXX" // 自己的私钥
代码

weather_api.h

1. #ifndef _WEATHER_API_H
2. #define _WEATHER_API_H
3. /**
4. * @file name : weather_api.h
5. * @brief     : 用于请求心知天气的信息, 现在的信息, 未来n天的气象信息(免费版仅能3天).
6. *              使用域名通过TCP连接到心知天气服务器, 采用cJSON进行解析.
7. *              模块化实现, 可选择英文、中文;天数;城市;
8. * @author    : RISE_AND_GRIND@163.com
9. * @date      : 2024年6月14日
10. * @version   : 1.0
11. * @note      :
12. * CopyRight (c)  2023-2024   RISE_AND_GRIND@163.com   All Right Reseverd
13. */
14. /***************************************头文件***************************************/
15. #include <sys/types.h>
16. #include <sys/socket.h>
17. #include <netdb.h>
18. #include <netinet/in.h>
19. #include <arpa/inet.h>
20. #include <stdio.h>
21. #include <errno.h>
22. #include <stdlib.h>
23. #include <string.h>
24. #include <unistd.h>
26. #include "cJSON.h"
28. /***************************************END******************************************/
29. /***************************************预处理***************************************/
30. // 目标服务器ip地址 端口号
31. // #define IPADDR "116.62.81.138"
32. #define SERVERHOSTNAME "api.seniverse.com" // 服务器域名
33. #define PORT 80
34. #define MAX_STRING_LENGTH 100 // 解析到的JSON键值的最大长度
35. #define BUFFERSIZE 4096       // 缓冲区大小
36. #define DAYS_COUNT 3          // 要查询的未来几天天气
37. // 配置信息 访问频限 20次/分钟 国内370个主要城市
38. #define KEY "XXXXXXXXX" // 自己的私钥
39. #define LOCAL "guangzhou"       // 解析的城市
40. #define TYPEINFO 0              // 1默认输出解析到的信息, 0关闭
41. /**
42. * 国内 370 个主要城市
43. * 1 天气实况，包括天气现象文字、代码和气温 3 项数据
44. * 2 未来 3 天天气预报，包括白天天气现象文字及代码、晚间天气现象文字及代码、当天最高温度和最低温度、风向风速
45. * 3 6 项基本类生活指数，包括穿衣、紫外线强度、洗车、旅游、感冒、运动指数
46. */
47. /***************************************END******************************************/
48. /***************************************数据类型***************************************/
49. // 请求的位置信息
50. typedef struct
51. {
52.     char id[MAX_STRING_LENGTH];              // 城市ID
53.     char name[MAX_STRING_LENGTH];            // 城市名称
54.     char country[MAX_STRING_LENGTH];         // 国家
55.     char path[MAX_STRING_LENGTH];            // 具体位置
56.     char timezone[MAX_STRING_LENGTH];        // 时区
57.     char timezone_offset[MAX_STRING_LENGTH]; // 时区偏移
58. } Location;
59. // 返回指定days天数的结果 定义未来天气结构体 未来15天/24小时  每天更新2次，8点和20点
60. typedef struct
61. {
62.     char date[MAX_STRING_LENGTH];                  // 日期
63.     char text_day[MAX_STRING_LENGTH];              // 白天天气现象文字：阴晴多云等
64.     char code_day[MAX_STRING_LENGTH];              // 白天天气现象代码
65.     char text_night[MAX_STRING_LENGTH];            // 夜间天气现象文字：阴晴多云等
66.     char code_night[MAX_STRING_LENGTH];            // 夜间天气现象代码
67.     char high[MAX_STRING_LENGTH];                  // 当天最高气温
68.     char low[MAX_STRING_LENGTH];                   // 当天最低气温
69.     char rainfall[MAX_STRING_LENGTH];              // 降水量：当天累计降水量，毫米(mm)
70.     char precip[MAX_STRING_LENGTH];                // 降水概率，范围0~100，单位百分比（目前仅支持国外城市）
71.     char wind_direction[MAX_STRING_LENGTH];        // 风向文字：地面10米风向，东、东南、南、西南等
72.     char wind_direction_degree[MAX_STRING_LENGTH]; // 风向角度，范围0~360, 地面10米风向，东、东南、南、西南等
73.     char wind_speed[MAX_STRING_LENGTH];            // 风速，单位km/h（当unit=c时）、mph（当unit=f时）
74.     char wind_scale[MAX_STRING_LENGTH];            // 风力等级：根据风速大小划分的等级
75.     char humidity[MAX_STRING_LENGTH];              // 相对湿度：地面2米湿度，百分比%
76. } Daily;
78. // 天气实况信息
79. typedef struct
80. {
81.     char text[MAX_STRING_LENGTH];        // 天气现象文字
82.     char code[MAX_STRING_LENGTH];        // 天气现象代码
83.     char temperature[MAX_STRING_LENGTH]; // 温度，单位为c摄氏度或f华氏度
84. } Now;
86. // 天气实况
87. typedef struct
88. {
89.     Location location;                   // 请求的位置信息
90.     Now now;                             //
91.     char last_update[MAX_STRING_LENGTH]; // 数据更新时间（该城市的本地时间）
92. } WeatherResults;
93. // 未来 3 天天气预报
94. typedef struct
95. {
96.     Location location;                   // 请求的位置信息
97.     Daily daily[DAYS_COUNT];             // 返回指定days天数的结果
98.     char last_update[MAX_STRING_LENGTH]; // 数据更新时间（该城市的本地时间）
99. } WeatherResultsFuture;
100. /***************************************END******************************************/
101. /**************************************函数声明**************************************/
102. /** 解析天气实况JSON信息
103. * @name      parse_weather
104. * @brief     解析天气实况JSON信息
105. * @param     json_data JSON格式的字符串(未解析的格式, 从接收区收到)
106. * @param     weather_results 接收天气实况解析结果的结构体
107. * @date      2024年6月14日
108. * @version   1.0
109. * @note      使用前提:WeatherResultsFuture weather_results_future;
110. */
111. void parse_weather(const char *json_data, WeatherResults *weather_results);
113. /** 解析未来3天天气JSON信息
114. * @name      parse_weather_future
115. * @brief     解析未来3天天气JSON信息
116. * @param     json_data JSON格式的字符串(未解析的格式, 从接收区收到)
117. * @param     weather_results_future 接收未来天气解析结果的结构体
118. * @date      2024年6月14日
119. * @version   1.0
120. * @note      使用前提:WeatherResultsFuture weather_results_future;
121. */
122. void parse_weather_future(const char *json_data, WeatherResultsFuture *weather_results_future);
123. /***************************************END******************************************/
124. // 打印解析后的天气实况信息
125. void PrintWeatherInfo(WeatherResults const *weather_results);
126. // 打印解析后的未来3天天气信息
127. void PrintWeatherFutureInfo(WeatherResultsFuture const *weather_results_future);
128. /**
129. * @brief 解析域名得到 IPv4 地址或 IPv6 地址，优先 IPv4
130. * @param hostname 域名字符串
131. * @param ipaddr 用于接收结果的字符数组
132. * @return 解析到 IPv4 地址返回 4，解析到 IPv6 地址返回 6，失败返回 -1
133. */
134. int resolve_hostname(const char *hostname, char *ipaddr);
135. /** 连接天气服务器
136. * @name      connectServer
137. * @brief     连接天气服务器
138. * @param     ipaddr 服务器ip地址
139. * @param     port 服务器端口
140. * @param     tcp_socket_fd 网络套接字描述符
141. * @return    成功 0; 失败-1 (会自动关闭套接字)
142. * @date      2024年6月14日
143. * @version   1.0
144. * @note      前提: int tcp_socket_fd=-1;//创建公用网络套接字描述符
145. *            注意: 会创建tcp套接字, 不会自动关闭! 需要做错误处理
146. *            失败会自动关闭套接字文件, 且tcp_socket_fd=-1;
147. *            成功, 用完记得手动关闭且tcp_socket_fd;
148. *
149. */
150. int connectServer(const char *ipaddr, int port, int *tcp_socket_fd);
151. /** 请求天气实况信息
152. * @name      getWeatherInfo
153. * @brief     请求天气实况信息并解析
154. * @param     tcp_socket_fd 网络套接字描述符
155. * @param     local 城市位置拼音 例如 "guangzhou"
156. * @param     language 接收的语言 例如 "zh-Hans"表示中文  英文:"en"
157. * @param     weather_results 天气实况接收结解析结果构体
158. * @date      2024年6月14日
159. * @version   1.0
160. * @note      中文:zh-Hans 英文:en
161. *  使用前提: connectServer(); char recvbuf[BUFFERSIZE]; // 接收缓冲区    WeatherResults weather_results;
162. */
163. void getWeatherInfo(int tcp_socket_fd, char const *local, char const *language, char *recvbuf, WeatherResults *weather_results);
165. /** 请求未来天气JSON信息
166. * @name      getWeatherFutureInfo
167. * @brief     请求未来天气JSON信息
168. * @param     tcp_socket_fd 网络套接字描述符
169. * @param     local 城市位置拼音 例如 "guangzhou"
170. * @param     language 接收的语言 例如 "zh-Hans"表示中文  英文:"en"
171. * @param     weather_results 天气实况接收结解析结果构体
172. * @date      2024年6月14日
173. * @version   1.0
174. * @note      中文:zh-Hans 英文:en
175. *  使用前提: connectServer(); char recvbuf[BUFFERSIZE]; // 接收缓冲区    WeatherResultsFuture weather_results_future;
176. */
177. void getWeatherFutureInfo(int tcp_socket_fd, char const *local, char const *language, char *recvbuf, WeatherResultsFuture *weather_results_future);
178. #endif //_WEATHER_API_H

复制代码

weather_api.c

1. /**
2. * @file name : weather_api.c
3. * @brief     : 用于请求心知天气的信息, 现在的信息, 未来n天的气象信息(免费版仅能3天).
4. *              使用域名通过TCP连接到心知天气服务器, 采用cJSON进行解析.
5. *              模块化实现, 可选择英文、中文;天数;城市;
6. * @author    : RISE_AND_GRIND@163.com
7. * @date      : 2024年6月14日
8. * @version   : 1.0
9. * @note      :
10. * CopyRight (c)  2023-2024   RISE_AND_GRIND@163.com   All Right Reseverd
11. */
12. #include "weather_api.h"
14. /** 解析天气实况JSON信息
15. * @name      parse_weather
16. * @brief     解析天气实况JSON信息
17. * @param     json_data JSON格式的字符串(未解析的格式, 从接收区收到)
18. * @param     weather_results 接收天气实况解析结果的结构体
19. * @date      2024年6月14日
20. * @version   1.0
21. * @note      使用前提:WeatherResultsFuture weather_results_future;
22. */
23. void parse_weather(const char *json_data, WeatherResults *weather_results)
24. {
25.     //  使用cJSON库解析JSON字符串
26.     cJSON *json = cJSON_Parse(json_data);
27.     if (json == NULL)
28.     {
29.         fprintf(stderr, "解析天气实况 JSON 错误\n");
30.         return;
31.     }
32. #if TYPEINFO
34.     // 把解析之后的JSON格式结构体进行输出
35.     printf("实时天气是\n%s\n", cJSON_Print(json));
36. #endif
37.     // 获取JSON对象中的"results"数组
38.     cJSON *results = cJSON_GetObjectItem(json, "results");
39.     if (results == NULL || !cJSON_IsArray(results))
40.     {
41.         fprintf(stderr, "查找“results”数组时出错\n");
42.         cJSON_Delete(json);
43.         return;
44.     }
46.     // 获取"results"数组中的第一个元素
47.     cJSON *result = cJSON_GetArrayItem(results, 0); // 假设数组中只有一个结果
48.     if (result == NULL)
49.     {
50.         fprintf(stderr, "在“results”数组中查找第一项时出错\n");
51.         cJSON_Delete(json);
52.         return;
53.     }
55.     // 获取"result"对象中的"location"对象
56.     cJSON *location = cJSON_GetObjectItem(result, "location");
57.     if (location != NULL)
58.     {
59.         // 将"location"对象中的各个字段值复制到weather_results->location结构体中
60.         strncpy(weather_results->location.id, cJSON_GetObjectItem(location, "id")->valuestring, MAX_STRING_LENGTH);
61.         strncpy(weather_results->location.name, cJSON_GetObjectItem(location, "name")->valuestring, MAX_STRING_LENGTH);
62.         strncpy(weather_results->location.country, cJSON_GetObjectItem(location, "country")->valuestring, MAX_STRING_LENGTH);
63.         strncpy(weather_results->location.path, cJSON_GetObjectItem(location, "path")->valuestring, MAX_STRING_LENGTH);
64.         strncpy(weather_results->location.timezone, cJSON_GetObjectItem(location, "timezone")->valuestring, MAX_STRING_LENGTH);
65.         strncpy(weather_results->location.timezone_offset, cJSON_GetObjectItem(location, "timezone_offset")->valuestring, MAX_STRING_LENGTH);
66.     }
68.     // 获取"result"对象中的"now"对象
69.     cJSON *now = cJSON_GetObjectItem(result, "now");
70.     if (now != NULL)
71.     {
72.         // 将"now"对象中的各个字段值复制到weather_results->now结构体中
73.         strncpy(weather_results->now.text, cJSON_GetObjectItem(now, "text")->valuestring, MAX_STRING_LENGTH);
74.         strncpy(weather_results->now.code, cJSON_GetObjectItem(now, "code")->valuestring, MAX_STRING_LENGTH);
75.         strncpy(weather_results->now.temperature, cJSON_GetObjectItem(now, "temperature")->valuestring, MAX_STRING_LENGTH);
76.     }
78.     // 将"result"对象中的"last_update"字段值复制到weather_results->last_update字符数组中
79.     strncpy(weather_results->last_update, cJSON_GetObjectItem(result, "last_update")->valuestring, MAX_STRING_LENGTH);
81.     // 释放cJSON对象
82.     cJSON_Delete(json);
83. }
85. /** 解析未来n天天气JSON信息
86. * @name      parse_weather_future
87. * @brief     解析未来3天天气JSON信息
88. * @param     json_data JSON格式的字符串(未解析的格式, 从接收区收到)
89. * @param     weather_results_future 接收未来天气解析结果的结构体
90. * @date      2024年6月14日
91. * @version   1.0
92. * @note      使用前提:WeatherResultsFuture weather_results_future;
93. */
94. void parse_weather_future(const char *json_data, WeatherResultsFuture *weather_results_future)
95. {
96.     // 使用cJSON库解析JSON字符串
97.     cJSON *json = cJSON_Parse(json_data);
98.     if (json == NULL)
99.     {
100.         fprintf(stderr, "Error parsing JSON\n");
101.         return;
102.     }
103. #if TYPEINFO
104.     // 把解析之后的JSON格式结构体进行输出
105.     printf("未来天气是\n%s\n", cJSON_Print(json));
106. #endif
107.     // 获取JSON对象中的"results"数组
108.     cJSON *results = cJSON_GetObjectItem(json, "results");
109.     if (results == NULL || !cJSON_IsArray(results))
110.     {
111.         fprintf(stderr, "查找“results”数组时出错\n");
112.         cJSON_Delete(json);
113.         return;
114.     }
116.     // 获取"results"数组中的第一个元素
117.     cJSON *result = cJSON_GetArrayItem(results, 0); // 假设数组中只有一个结果
118.     if (result == NULL)
119.     {
120.         fprintf(stderr, "在“results”数组中查找第一项时出错\n");
121.         cJSON_Delete(json);
122.         return;
123.     }
125.     // 获取"result"对象中的"location"对象
126.     cJSON *location = cJSON_GetObjectItem(result, "location");
127.     if (location != NULL)
128.     {
129.         // 将"location"对象中的各个字段值复制到weather_results_future->location结构体中
130.         strncpy(weather_results_future->location.id, cJSON_GetObjectItem(location, "id")->valuestring, MAX_STRING_LENGTH);
131.         strncpy(weather_results_future->location.name, cJSON_GetObjectItem(location, "name")->valuestring, MAX_STRING_LENGTH);
132.         strncpy(weather_results_future->location.country, cJSON_GetObjectItem(location, "country")->valuestring, MAX_STRING_LENGTH);
133.         strncpy(weather_results_future->location.path, cJSON_GetObjectItem(location, "path")->valuestring, MAX_STRING_LENGTH);
134.         strncpy(weather_results_future->location.timezone, cJSON_GetObjectItem(location, "timezone")->valuestring, MAX_STRING_LENGTH);
135.         strncpy(weather_results_future->location.timezone_offset, cJSON_GetObjectItem(location, "timezone_offset")->valuestring, MAX_STRING_LENGTH);
136.     }
138.     // 获取"result"对象中的"daily"数组
139.     cJSON *daily = cJSON_GetObjectItem(result, "daily");
140.     if (daily != NULL && cJSON_IsArray(daily))
141.     {
142.         // 遍历"daily"数组中的每一天的天气数据
143.         for (int i = 0; i < DAYS_COUNT; i++)
144.         {
145.             cJSON *day = cJSON_GetArrayItem(daily, i);
146.             if (day != NULL)
147.             {
148.                 // 将"day"对象中的各个字段值复制到weather_results_future->daily[i]结构体中
149.                 strncpy(weather_results_future->daily[i].date, cJSON_GetObjectItem(day, "date")->valuestring, MAX_STRING_LENGTH);
150.                 strncpy(weather_results_future->daily[i].text_day, cJSON_GetObjectItem(day, "text_day")->valuestring, MAX_STRING_LENGTH);
151.                 strncpy(weather_results_future->daily[i].code_day, cJSON_GetObjectItem(day, "code_day")->valuestring, MAX_STRING_LENGTH);
152.                 strncpy(weather_results_future->daily[i].text_night, cJSON_GetObjectItem(day, "text_night")->valuestring, MAX_STRING_LENGTH);
153.                 strncpy(weather_results_future->daily[i].code_night, cJSON_GetObjectItem(day, "code_night")->valuestring, MAX_STRING_LENGTH);
154.                 strncpy(weather_results_future->daily[i].high, cJSON_GetObjectItem(day, "high")->valuestring, MAX_STRING_LENGTH);
155.                 strncpy(weather_results_future->daily[i].low, cJSON_GetObjectItem(day, "low")->valuestring, MAX_STRING_LENGTH);
156.                 strncpy(weather_results_future->daily[i].rainfall, cJSON_GetObjectItem(day, "rainfall")->valuestring, MAX_STRING_LENGTH);
157.                 strncpy(weather_results_future->daily[i].precip, cJSON_GetObjectItem(day, "precip")->valuestring, MAX_STRING_LENGTH);
158.                 strncpy(weather_results_future->daily[i].wind_direction, cJSON_GetObjectItem(day, "wind_direction")->valuestring, MAX_STRING_LENGTH);
160.                 strncpy(weather_results_future->daily[i].wind_direction_degree, cJSON_GetObjectItem(day, "wind_direction_degree")->valuestring, MAX_STRING_LENGTH);
162.                 strncpy(weather_results_future->daily[i].wind_speed, cJSON_GetObjectItem(day, "wind_speed")->valuestring, MAX_STRING_LENGTH);
163.                 strncpy(weather_results_future->daily[i].wind_scale, cJSON_GetObjectItem(day, "wind_scale")->valuestring, MAX_STRING_LENGTH);
164.                 strncpy(weather_results_future->daily[i].humidity, cJSON_GetObjectItem(day, "humidity")->valuestring, MAX_STRING_LENGTH);
165.             }
166.         }
167.     }
169.     // 将"result"对象中的"last_update"字段值复制到weather_results_future->last_update字符数组中
170.     strncpy(weather_results_future->last_update, cJSON_GetObjectItem(result, "last_update")->valuestring, MAX_STRING_LENGTH);
172.     // 释放cJSON对象
173.     cJSON_Delete(json);
174. }
176. // 打印解析后的天气实况信息
177. void PrintWeatherInfo(WeatherResults const *weather_results)
178. {
179.     // 打印解析后的结构体内容
180.     printf("\n");
181.     printf("位置 ID: %s\n", weather_results->location.id);
182.     printf("位置名称: %s\n", weather_results->location.name);
183.     printf("国家: %s\n", weather_results->location.country);
184.     printf("位置: %s\n", weather_results->location.path);
185.     printf("时区: %s\n", weather_results->location.timezone);
186.     printf("时区偏移: %s\n", weather_results->location.timezone_offset);
188.     printf("天气情况: %s\n", weather_results->now.text);
189.     printf("天气代码: %s\n", weather_results->now.code);
190.     printf("温度: %s\n", weather_results->now.temperature);
192.     printf("最后更新时间: %s\n", weather_results->last_update);
193.     printf("\n");
194. }
196. // 打印解析后的未来3天天气信息
197. void PrintWeatherFutureInfo(WeatherResultsFuture const *weather_results_future)
198. {
200.     // 打印解析后的结构体内容
201.     printf("\n");
202.     printf("城市 ID:\t %s\n", weather_results_future->location.id);
203.     printf("城市名称:\t %s\n", weather_results_future->location.name);
204.     printf("国家:\t\t %s\n", weather_results_future->location.country);
205.     printf("具体位置:\t %s\n", weather_results_future->location.path);
206.     printf("时区:\t\t %s\n", weather_results_future->location.timezone);
207.     printf("时区偏移:\t %s\n", weather_results_future->location.timezone_offset);
209.     for (int i = 0; i < DAYS_COUNT; i++)
210.     {
211.         printf("\n");
213.         printf("日期:\t\t\t %s\n", weather_results_future->daily[i].date);
214.         printf("白天天气现象文字:\t %s\n", weather_results_future->daily[i].text_day);
215.         printf("白天天气现象代码:\t %s\n", weather_results_future->daily[i].code_day);
216.         printf("夜间天气现象文字:\t %s\n", weather_results_future->daily[i].text_night);
217.         printf("夜间天气现象代码:\t %s\n", weather_results_future->daily[i].code_night);
218.         printf("当天最高气温:\t %s\n", weather_results_future->daily[i].high);
219.         printf("当天最低气温:\t %s\n", weather_results_future->daily[i].low);
220.         printf("降水量：\t %s\n", weather_results_future->daily[i].rainfall);
221.         printf("降水概率:\t %s\n", weather_results_future->daily[i].precip);
222.         printf("风向文字:\t %s\n", weather_results_future->daily[i].wind_direction);
223.         printf("风向角度:\t %s\n", weather_results_future->daily[i].wind_direction_degree);
224.         printf("风速:\t\t %s\n", weather_results_future->daily[i].wind_speed);
225.         printf("风力等级:\t %s\n", weather_results_future->daily[i].wind_scale);
226.         printf("相对湿度:\t %s\n", weather_results_future->daily[i].humidity);
227.     }
229.     printf("数据更新时间:\t %s\n", weather_results_future->last_update);
230.     printf("\n");
231. }
233. /** 解析域名得到 IPv4 地址或 IPv6 地址
234. * @brief 解析域名得到 IPv4 地址或 IPv6 地址，优先 IPv4
235. * @param hostname 域名字符串
236. * @param ipaddr 用于接收结果的字符数组
237. * @return 解析到 IPv4 地址返回 4，解析到 IPv6 地址返回 6，失败返回 -1
238. */
239. int resolve_hostname(const char *hostname, char *ipaddr)
240. {
241.     // 定义 addrinfo 结构体变量，用于存储地址信息
242.     struct addrinfo hints, *res, *p;
243.     int errcode; // 存储 getaddrinfo 函数的返回值
244.     void *ptr;   // 指向 IP 地址的指针
246.     // 清空 hints 结构体并设置相关参数
247.     memset(&hints, 0, sizeof(hints));
248.     hints.ai_family = AF_UNSPEC;     // 不指定 IPv4 或 IPv6
249.     hints.ai_socktype = SOCK_STREAM; // TCP 流套接字
251.     // 调用 getaddrinfo 函数获取主机名对应的地址信息
252.     errcode = getaddrinfo(hostname, NULL, &hints, &res);
253.     if (errcode != 0)
254.     {
255.         // 如果 getaddrinfo 返回非零值，则表示出错，打印错误信息并返回 -1
256.         fprintf(stderr, "getaddrinfo: %s\n", gai_strerror(errcode));
257.         return -1;
258.     }
260.     // 遍历返回的地址信息链表
261.     for (p = res; p != NULL; p = p->ai_next)
262.     {
263.         // 判断地址族是否为 IPv4
264.         if (p->ai_family == AF_INET)
265.         {
266.             // 将 IPv4 地址赋给 ptr
267.             ptr = &((struct sockaddr_in *)p->ai_addr)->sin_addr;
268.             // 将地址转换为字符串形式，并存储在 ipaddr 中
269.             inet_ntop(p->ai_family, ptr, ipaddr, INET6_ADDRSTRLEN);
270.             freeaddrinfo(res); // 释放 getaddrinfo 分配的内存
271.             return 4;          // 返回 4 表示解析到 IPv4 地址
272.         }
273.     }
275.     // 如果没有找到 IPv4 地址，继续寻找 IPv6 地址
276.     for (p = res; p != NULL; p = p->ai_next)
277.     {
278.         // 判断地址族是否为 IPv6
279.         if (p->ai_family == AF_INET6)
280.         {
281.             // 将 IPv6 地址赋给 ptr
282.             ptr = &((struct sockaddr_in6 *)p->ai_addr)->sin6_addr;
283.             // 将地址转换为字符串形式，并存储在 ipaddr 中
284.             inet_ntop(p->ai_family, ptr, ipaddr, INET6_ADDRSTRLEN);
285.             freeaddrinfo(res); // 释放 getaddrinfo 分配的内存
286.             return 6;          // 返回 6 表示解析到 IPv6 地址
287.         }
288.     }
290.     // 如果没有找到任何地址，释放 getaddrinfo 分配的内存并返回 -1
291.     freeaddrinfo(res);
292.     return -1;
293. }
295. /** 连接天气服务器
296. * @name      connectServer
297. * @brief     连接天气服务器
298. * @param     ipaddr 服务器ip地址
299. * @param     port 服务器端口
300. * @param     tcp_socket_fd 网络套接字描述符
301. * @return    成功 0; 失败-1 (会自动关闭套接字)
302. * @date      2024年6月14日
303. * @version   1.0
304. * @note      前提: int tcp_socket_fd=-1;//创建公用网络套接字描述符
305. *            注意: 会创建tcp套接字, 不会自动关闭! 需要做错误处理
306. *            失败会自动关闭套接字文件, 且tcp_socket_fd=-1;
307. *            成功, 用完记得手动关闭且tcp_socket_fd;
308. *
309. */
310. int connectServer(const char *ipaddr, int port, int *tcp_socket_fd)
311. {
312.     /**********************1.创建TCP套接字**********************/
313.     *tcp_socket_fd = socket(AF_INET, SOCK_STREAM, 0);
314.     if (*tcp_socket_fd == -1)
315.     {
316.         fprintf(stderr, "创建TCP套接字错误, errno:%d,%s\n", errno, strerror(errno));
317.         exit(1);
318.     }
320.     /******************2.发起连接请求，等待接受服务器接受连接 建立TCP连接*******************/
321.     struct sockaddr_in dest_addr;
322.     dest_addr.sin_family = AF_INET;                // 协议族，是固定的
323.     dest_addr.sin_port = htons(PORT);              // 服务器端口，必须转换为网络字节序
324.                                                    // dest_addr.sin_addr.s_addr = inet_addr(IPADDR); // 服务器地址
325.     dest_addr.sin_addr.s_addr = inet_addr(ipaddr); // 服务器地址
327.     /******************3. 客户端连接成功*******************************/
328.     int ret = connect(*tcp_socket_fd, (struct sockaddr *)&dest_addr, sizeof(dest_addr));
329.     if (ret < 0)
330.     {
331.         fprintf(stderr, "客户端连接失败, errno:%d,%s\n", errno, strerror(errno));
332.         close(*tcp_socket_fd);
333.         printf("TCP套接字已经关闭!\n");
334.         *tcp_socket_fd = -1; // 恢复失败的情况
335.         return -1;
336.     }
337.     return 0;
338. }
340. /** 请求天气实况信息
341. * @name      getWeatherInfo
342. * @brief     请求天气实况信息并解析
343. * @param     tcp_socket_fd 网络套接字描述符
344. * @param     local 城市位置拼音 例如 "guangzhou"
345. * @param     language 接收的语言 例如 "zh-Hans"表示中文  英文:"en"
346. * @param     weather_results 天气实况接收结解析结果构体
347. * @date      2024年6月14日
348. * @version   1.0
349. * @note      中文:zh-Hans 英文:en
350. *  使用前提: connectServer(); char recvbuf[BUFFERSIZE]; // 接收缓冲区    WeatherResults weather_results;
351. */
352. void getWeatherInfo(int tcp_socket_fd, char const *local, char const *language, char *recvbuf, WeatherResults *weather_results)
353. {
354.     /**************************4. 构建实时天气HTTP请求内容****************************************/
355.     // 用于存储HTTP的请求内容: 请求行 + 请求字段 + \r\n + 请求包体（可选）
356.     char reqbuf[1024] = {0}; // 储存http请求内容临时缓存区
357.     sprintf(reqbuf, "GET https://api.seniverse.com/v3/weather/now.json?key=%s&location=%s&language=%s&unit=c "
358.                     "HTTP/1.1"
359.                     "\r\n"
360.                     "Host:api.seniverse.com\r\n"
361.                     "\r\n",
362.             KEY, local, language);
363.     /**************************5. 发送http请求内容****************************************/
364.     // 双方建立连接，此时可以利用HTTP协议发送请求信息，并等待服务器的响应  基于请求/响应
365.     send(tcp_socket_fd, reqbuf, strlen(reqbuf), 0);
366.     /**************************6. 等待服务器的响应****************************************/
367.     /*************请求实时天气**************** */
368.     bzero(recvbuf, BUFFERSIZE); // 清除缓冲区
369.     // 第一次返回的响应参数
370.     recv(tcp_socket_fd, recvbuf, BUFFERSIZE, 0); // 从TCP套接字接收数据
372. #if TYPEINFO
373.     printf("%s\n", recvbuf); // 打印接收到的响应参数
374. #endif
375.     bzero(recvbuf, BUFFERSIZE);
376.     // 第二次返回的响应包体
377.     recv(tcp_socket_fd, recvbuf, BUFFERSIZE, 0);
378. #if TYPEINFO
379.     printf("%s\n", recvbuf); // 打印接收到的响应包体
380. #endif
381.     /*************解析实时天气**************** */
382.     parse_weather(recvbuf, weather_results); // 调用解析函数，解析接收到的JSON数据并填充结构体
384.     // 打印解析后的结构体内容
385.     PrintWeatherInfo(weather_results);
386. }
388. /** 请求未来天气JSON信息
389. * @name      getWeatherFutureInfo
390. * @brief     请求未来天气JSON信息
391. * @param     tcp_socket_fd 网络套接字描述符
392. * @param     local 城市位置拼音 例如 "guangzhou"
393. * @param     language 接收的语言 例如 "zh-Hans"表示中文  英文:"en"
394. * @param     weather_results 天气实况接收结解析结果构体
395. * @date      2024年6月14日
396. * @version   1.0
397. * @note      中文:zh-Hans 英文:en
398. *  使用前提: connectServer(); char recvbuf[BUFFERSIZE]; // 接收缓冲区    WeatherResultsFuture weather_results_future;
399. */
400. void getWeatherFutureInfo(int tcp_socket_fd, char const *local, char const *language, char *recvbuf, WeatherResultsFuture *weather_results_future)
401. {
402.     /*********************************请求未来2天天气************************************** */
403.     /**************************4. 构建未来天气HTTP请求内容****************************************/
404.     // 用于存储HTTP的请求内容: 请求行 + 请求字段 + \r\n + 请求包体（可选）
405.     char reqbuf[1024] = {0}; // 储存http请求内容临时缓存区
406.     sprintf(reqbuf, "GET https://api.seniverse.com/v3/weather/daily.json?key=%s&location=%s&language=%s&unit=c&start=0&days=%d "
407.                     "HTTP/1.1"
408.                     "\r\n"
409.                     "Host:api.seniverse.com\r\n"
410.                     "\r\n",
411.             KEY, local, language, DAYS_COUNT);
412.     /**************************5. 发送http请求内容****************************************/
413.     // 双方建立连接，此时可以利用HTTP协议发送请求信息，并等待服务器的响应  基于请求/响应
414.     send(tcp_socket_fd, reqbuf, strlen(reqbuf), 0);
416.     /**************************6. 等待服务器的响应****************************************/
417.     /*************请求实时天气**************** */
418.     bzero(recvbuf, BUFFERSIZE); // 清空接收缓冲区
419.     // 第一次返回的响应参数
420.     recv(tcp_socket_fd, recvbuf, BUFFERSIZE, 0); // 从TCP套接字接收数据
421. #if TYPEINFO
422.     printf("%s\n", recvbuf); // 打印接收到的响应参数
423. #endif                       // 打印接收到的数据
424.     bzero(recvbuf, BUFFERSIZE);
425.     // 第二次返回的响应包体
426.     recv(tcp_socket_fd, recvbuf, BUFFERSIZE, 0);
427. #if TYPEINFO
428.     printf("%s\n", recvbuf); // 打印接收到的响应包体
429. #endif
430.     /*************解析未来天气**************** */
432.     parse_weather_future(recvbuf, weather_results_future); // 调用解析函数，解析接收到的JSON数据并填充结构体
433.     // 打印解析后的结构体内容
434.     PrintWeatherFutureInfo(weather_results_future);
435. }
437. // 使用示范
438. #if 0
439. #include <stdio.h>
440. #include "cJSON.h"
441. #include "weather_api.h"
443. int main(int argc, char const *argv[])
444. {
445.     /***********域名解析****************/
446.     char ipaddr[64] = {0};
447.     if (resolve_hostname(SERVERHOSTNAME, ipaddr) != -1)
448.     {
449.         printf("天气服务器域名 %s 的IP地址是 %s\n", SERVERHOSTNAME, ipaddr);
450.     }
451.     else
452.     {
453.         printf(" %s 解析域名失败\n", SERVERHOSTNAME);
454.     }
455.     // TCP连接服务器
456.     int tcp_socket_fd = -1;
457.     if (connectServer(ipaddr, PORT, &tcp_socket_fd) != 0)
458.     {
459.         perror("连接天气服务器失败");
460.         return -1;
461.     }
463.     /**************************请求实时天气HTTP请求****************************************/
464.     char recvbuf[BUFFERSIZE]; // 接收缓冲区
465.     WeatherResults weather_results;
466.     getWeatherInfo(tcp_socket_fd, LOCAL, "zh-Hans", recvbuf, &weather_results);
468.     WeatherResultsFuture weather_results_future;
469.     getWeatherFutureInfo(tcp_socket_fd, LOCAL, "zh-Hans", recvbuf, &weather_results_future);
470.     printf("\n信阳气象信息\n");
471.     getWeatherInfo(tcp_socket_fd, "xinyang", "zh-Hans", recvbuf, &weather_results);
472.     getWeatherFutureInfo(tcp_socket_fd, "xinyang", "zh-Hans", recvbuf, &weather_results_future);
473.     close(tcp_socket_fd);
474.     return 0;
475. }
477. #endif

复制代码

demo.c

下面是使用示范

1. #include <stdio.h>
2. #include "weather_api.h"
4. int main(int argc, char const *argv[])
5. {
6.     /***********域名解析****************/
7.     char ipaddr[64] = {0};
8.     if (resolve_hostname(SERVERHOSTNAME, ipaddr) != -1)
9.     {
10.         printf("天气服务器域名 %s 的IP地址是 %s\n", SERVERHOSTNAME, ipaddr);
11.     }
12.     else
13.     {
14.         printf(" %s 解析域名失败\n", SERVERHOSTNAME);
15.     }
16.     // TCP连接服务器
17.     int tcp_socket_fd = -1;
18.     if (connectServer(ipaddr, PORT, &tcp_socket_fd) != 0)
19.     {
20.         perror("连接天气服务器失败");
21.         return -1;
22.     }
24.     /**************************请求实时天气HTTP请求****************************************/
25.     char recvbuf[BUFFERSIZE]; // 接收缓冲区
26.     WeatherResults weather_results;
27.     getWeatherInfo(tcp_socket_fd, LOCAL, "zh-Hans", recvbuf, &weather_results);
29.     WeatherResultsFuture weather_results_future;
30.     getWeatherFutureInfo(tcp_socket_fd, LOCAL, "zh-Hans", recvbuf, &weather_results_future);
31.     printf("\n信阳气象信息\n");
32.     getWeatherInfo(tcp_socket_fd, "xinyang", "zh-Hans", recvbuf, &weather_results);
33.     getWeatherFutureInfo(tcp_socket_fd, "xinyang", "zh-Hans", recvbuf, &weather_results_future);
34.     close(tcp_socket_fd);
35.     return 0;
36. }

复制代码

cJSON.h

下面是我汉化过的cJSON.h

1. // clang-format off
3. /*
4.   Copyright (c) 2009-2017 Dave Gamble and cJSON contributors
6.   Permission is hereby granted, free of charge, to any person obtaining a copy
7.   of this software and associated documentation files (the "Software"), to deal
8.   in the Software without restriction, including without limitation the rights
9.   to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10.   copies of the Software, and to permit persons to whom the Software is
11.   furnished to do so, subject to the following conditions:
13.   The above copyright notice and this permission notice shall be included in
14.   all copies or substantial portions of the Software.
16.   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17.   IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18.   FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19.   AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20.   LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21.   OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
22.   THE SOFTWARE.
23. */
24. /*
25.   版权所有 (c) 2009-2017 Dave Gamble 和 cJSON 贡献者
27.   特此免费授予任何获得本软件及相关文档文件（“软件”）副本的个人，不受限制地处理本软件，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本，并允许向其提供本软件的人员这样做，须符合以下条件：
29.   上述版权声明和本许可声明应包含在本软件的所有副本或主要部分中。
31.   本软件按“原样”提供，不提供任何形式的明示或暗示担保，包括但不限于适销性、适用性和非侵权的担保。在任何情况下，作者或版权持有人均不对因本软件或本软件的使用或其他交易引起的任何索赔、损害或其他责任承担责任，无论是在合同诉讼中、侵权行为中还是其他方面。
32. */
34. #ifndef cJSON__h
35. #define cJSON__h
37. #ifdef __cplusplus
38. extern "C"
39. {
40. #endif
42. #if !defined(__WINDOWS__) && (defined(WIN32) || defined(WIN64) || defined(_MSC_VER) || defined(_WIN32))
43. #define __WINDOWS__
44. #endif
46. #ifdef __WINDOWS__
48.   /* When compiling for windows, we specify a specific calling convention to avoid issues where we are being called from a project with a different default calling convention.  For windows you have 3 define options:
50.   CJSON_HIDE_SYMBOLS - Define this in the case where you don't want to ever dllexport symbols
51.   CJSON_EXPORT_SYMBOLS - Define this on library build when you want to dllexport symbols (default)
52.   CJSON_IMPORT_SYMBOLS - Define this if you want to dllimport symbol
54.   For *nix builds that support visibility attribute, you can define similar behavior by
56.   setting default visibility to hidden by adding
57.   -fvisibility=hidden (for gcc)
58.   or
59.   -xldscope=hidden (for sun cc)
60.   to CFLAGS
62.   then using the CJSON_API_VISIBILITY flag to "export" the same symbols the way CJSON_EXPORT_SYMBOLS does
64.   */
65.   /* 在为 Windows 编译时，我们指定一个特定的调用约定，以避免在从具有不同默认调用约定的项目中调用时出现问题。对于 Windows，有 3 个定义选项：
67.   CJSON_HIDE_SYMBOLS - 在不希望导出符号时定义
68.   CJSON_EXPORT_SYMBOLS - 在库构建时定义以导出符号（默认）
69.   CJSON_IMPORT_SYMBOLS - 在希望导入符号时定义
71.   对于支持可见性属性的 *nix 构建，您可以通过以下方式定义类似的行为：
73.   通过添加 -fvisibility=hidden（对于 gcc）或 -xldscope=hidden（对于 sun cc）到 CFLAGS 来设置默认可见性为隐藏
75.   然后使用 CJSON_API_VISIBILITY 标志以与 CJSON_EXPORT_SYMBOLS 相同的方式“导出”相同的符号
76.   */
77. #define CJSON_CDECL __cdecl
78. #define CJSON_STDCALL __stdcall
80. /* export symbols by default, this is necessary for copy pasting the C and header file */
81. /* 默认导出符号，这是复制粘贴 C 和头文件所必需的 */
82. #if !defined(CJSON_HIDE_SYMBOLS) && !defined(CJSON_IMPORT_SYMBOLS) && !defined(CJSON_EXPORT_SYMBOLS)
83. #define CJSON_EXPORT_SYMBOLS
84. #endif
86. #if defined(CJSON_HIDE_SYMBOLS)
87. #define CJSON_PUBLIC(type) type CJSON_STDCALL
88. #elif defined(CJSON_EXPORT_SYMBOLS)
89. #define CJSON_PUBLIC(type) __declspec(dllexport) type CJSON_STDCALL
90. #elif defined(CJSON_IMPORT_SYMBOLS)
91. #define CJSON_PUBLIC(type) __declspec(dllimport) type CJSON_STDCALL
92. #endif
93. #else /* !__WINDOWS__ */
94. #define CJSON_CDECL
95. #define CJSON_STDCALL
97. #if (defined(__GNUC__) || defined(__SUNPRO_CC) || defined(__SUNPRO_C)) && defined(CJSON_API_VISIBILITY)
98. #define CJSON_PUBLIC(type) __attribute__((visibility("default"))) type
99. #else
100. #define CJSON_PUBLIC(type) type
101. #endif
102. #endif
104. /* project version */
105. /* 项目版本 */
106. #define CJSON_VERSION_MAJOR 1
107. #define CJSON_VERSION_MINOR 7
108. #define CJSON_VERSION_PATCH 18
110. #include <stddef.h>
112. /* cJSON Types: */
113. /* cJSON 类型: */
114. #define cJSON_Invalid (0)
115. #define cJSON_False (1 << 0)
116. #define cJSON_True (1 << 1)
117. #define cJSON_NULL (1 << 2)
118. #define cJSON_Number (1 << 3)
119. #define cJSON_String (1 << 4)
120. #define cJSON_Array (1 << 5)
121. #define cJSON_Object (1 << 6)
122. #define cJSON_Raw (1 << 7) /* raw json */ /* 原始 JSON */
124. #define cJSON_IsReference 256
125. #define cJSON_StringIsConst 512
127.   /* The cJSON structure: */
128.   /* cJSON 结构体定义: */
129.   typedef struct cJSON
130.   {
131.     /* next/prev allow you to walk array/object chains. Alternatively, use GetArraySize/GetArrayItem/GetObjectItem */
132.     /* next/prev 允许您遍历数组/对象链。或者，使用 GetArraySize/GetArrayItem/GetObjectItem */
133.     struct cJSON *next;
134.     struct cJSON *prev;
135.     /* An array or object item will have a child pointer pointing to a chain of the items in the array/object. */
136.     /* 数组或对象项将具有指向数组/对象中项链的子指针。 */
137.     struct cJSON *child;
139.     /* The type of the item, as above. */
140.     /* 项目的类型，如上所述。 */
141.     int type;
143.     /* The item's string, if type==cJSON_String  and type == cJSON_Raw */
144.     /* 项目的字符串，如果 type==cJSON_String 和 type == cJSON_Raw */
145.     char *valuestring;
146.     /* writing to valueint is DEPRECATED, use cJSON_SetNumberValue instead */
147.     /* 写入 valueint 已弃用，请改用 cJSON_SetNumberValue */
148.     int valueint;
149.     /* The item's number, if type==cJSON_Number */
150.     /* 项目的数字，如果 type==cJSON_Number */
151.     double valuedouble;
153.     /* The item's name string, if this item is the child of, or is in the list of subitems of an object. */
154.     /* 项目的名称字符串，如果该项目是对象的子项或在对象的子项列表中。 */
155.     char *string;
156.   } cJSON;
158.   /* cJSON 钩子函数结构体 */
159.   typedef struct cJSON_Hooks
160.   {
161.     /* malloc/free are CDECL on Windows regardless of the default calling convention of the compiler, so ensure the hooks allow passing those functions directly. */
162.     /* malloc/free 在 Windows 上是 CDECL，无论编译器的默认调用约定如何，因此确保钩子允许直接传递这些函数。 */
163.     void *(CJSON_CDECL *malloc_fn)(size_t sz);
164.     void(CJSON_CDECL *free_fn)(void *ptr);
165.   } cJSON_Hooks;
167.   typedef int cJSON_bool;
169.   /* Limits how deeply nested arrays/objects can be before cJSON rejects to parse them.
170.    * This is to prevent stack overflows. */
171.   /* 限制数组/对象嵌套的深度，超过此深度 cJSON 将拒绝解析。防止堆栈溢出。 */
172. #ifndef CJSON_NESTING_LIMIT
173. #define CJSON_NESTING_LIMIT 1000
174. #endif
176.   /* returns the version of cJSON as a string */
177.   /**
178.    * @name      cJSON_Version
179.    * @brief     返回 cJSON 版本号的字符串
180.    * @return    const char* 版本号字符串
181.    */
182.   CJSON_PUBLIC(const char *)  cJSON_Version(void);
184.   /* Supply malloc, realloc and free functions to cJSON */
185.   /**
186.    * @name      cJSON_InitHooks
187.    * @brief     提供 malloc、realloc 和 free 函数给 cJSON 使用
188.    * @param     hooks cJSON_Hooks 结构体指针，包含自定义的 malloc 和 free 函数
189.    */
190.   CJSON_PUBLIC(void)  cJSON_InitHooks(cJSON_Hooks *hooks);
192.   /* Memory Management: the caller is always responsible to free the results from all variants of cJSON_Parse (with cJSON_Delete) and cJSON_Print (with stdlib free, cJSON_Hooks.free_fn, or cJSON_free as appropriate). The exception is cJSON_PrintPreallocated, where the caller has full responsibility of the buffer. */
193.   /* Supply a block of JSON, and this returns a cJSON object you can interrogate. */
194.   /**
195.    * @name      cJSON_Parse
196.    * @brief     解析 JSON 字符串并返回 cJSON 对象
197.    * @param     value JSON 字符串
198.    * @return    cJSON* 解析后的 cJSON 对象
199.    * @note      调用者负责释放返回的 cJSON 对象（使用 cJSON_Delete）
200.    */
201.   CJSON_PUBLIC(cJSON *)  cJSON_Parse(const char *value);
202.   /**
203.    * @name      cJSON_ParseWithLength
204.    * @brief     解析指定长度的 JSON 字符串并返回 cJSON 对象
205.    * @param     value JSON 字符串
206.    * @param     buffer_length 字符串长度
207.    * @return    cJSON* 解析后的 cJSON 对象
208.    * @note      调用者负责释放返回的 cJSON 对象（使用 cJSON_Delete）
209.    */
210.   CJSON_PUBLIC(cJSON *)  cJSON_ParseWithLength(const char *value, size_t buffer_length);
211.   /* ParseWithOpts allows you to require (and check) that the JSON is null terminated, and to retrieve the pointer to the final byte parsed. */
212.   /* If you supply a ptr in return_parse_end and parsing fails, then return_parse_end will contain a pointer to the error so will match cJSON_GetErrorPtr(). */
213.   /**
214.    * @name      cJSON_ParseWithOpts
215.    * @brief     解析 JSON 字符串并返回 cJSON 对象，允许指定是否要求 JSON 以 null 结尾，并检索解析结束的指针
216.    * @param     value JSON 字符串
217.    * @param     return_parse_end 解析结束的指针
218.    * @param     require_null_terminated 是否要求 JSON 以 null 结尾
219.    * @return    cJSON* 解析后的 cJSON 对象
220.    * @note      调用者负责释放返回的 cJSON 对象（使用 cJSON_Delete）
221.    */
222.   CJSON_PUBLIC(cJSON *)  cJSON_ParseWithOpts(const char *value, const char **return_parse_end, cJSON_bool require_null_terminated);
223.   /**
224.    * @name      cJSON_ParseWithLengthOpts
225.    * @brief     解析指定长度的 JSON 字符串并返回 cJSON 对象，允许指定是否要求 JSON 以 null 结尾，并检索解析结束的指针
226.    * @param     value JSON 字符串
227.    * @param     buffer_length 字符串长度
228.    * @param     return_parse_end 解析结束的指针
229.    * @param     require_null_terminated 是否要求 JSON 以 null 结尾
230.    * @return    cJSON* 解析后的 cJSON 对象
231.    * @note      调用者负责释放返回的 cJSON 对象（使用 cJSON_Delete）
232.    */
233.   CJSON_PUBLIC(cJSON *)  cJSON_ParseWithLengthOpts(const char *value, size_t buffer_length, const char **return_parse_end, cJSON_bool require_null_terminated);
235.   /* Render a cJSON entity to text for transfer/storage. */
237.   /**
238.    * @name      cJSON_Print
239.    * @brief     将 cJSON 对象渲染为文本（带格式）
240.    * @param     item cJSON 对象
241.    * @return    char* 渲染后的文本
242.    * @note      调用者负责释放返回的字符串（使用 stdlib free、cJSON_Hooks.free_fn 或 cJSON_free）
243.    */
244.   CJSON_PUBLIC(char *)  cJSON_Print(const cJSON *item);
246.   /* Render a cJSON entity to text for transfer/storage without any formatting. */
247.   /**
248.    * @name      cJSON_PrintUnformatted
249.    * @brief     将 cJSON 对象渲染为文本（无格式）
250.    * @param     item cJSON 对象
251.    * @return    char* 渲染后的文本
252.    * @note      调用者负责释放返回的字符串（使用 stdlib free、cJSON_Hooks.free_fn 或 cJSON_free）
253.    */
254.   CJSON_PUBLIC(char *)  cJSON_PrintUnformatted(const cJSON *item);
256.   /* Render a cJSON entity to text using a buffered strategy. prebuffer is a guess at the final size. guessing well reduces reallocation. fmt=0 gives unformatted, =1 gives formatted */
257.   /**
258.    * @name      cJSON_PrintBuffered
259.    * @brief     使用缓冲策略将 cJSON 对象渲染为文本
260.    * @param     item cJSON 对象
261.    * @param     prebuffer 预缓冲大小
262.    * @param     fmt 是否格式化输出
263.    * @return    char* 渲染后的文本
264.    * @note      调用者负责释放返回的字符串（使用 stdlib free、cJSON_Hooks.free_fn 或 cJSON_free）
265.    */
266.   CJSON_PUBLIC(char *)  cJSON_PrintBuffered(const cJSON *item, int prebuffer, cJSON_bool fmt);
267.   /* Render a cJSON entity to text using a buffer already allocated in memory with given length. Returns 1 on success and 0 on failure. */
268.   /* NOTE: cJSON is not always 100% accurate in estimating how much memory it will use, so to be safe allocate 5 bytes more than you actually need */
269.   /**
270.    * @name      cJSON_PrintPreallocated
271.    * @brief     使用已分配的缓冲区将 cJSON 对象渲染为文本
272.    * @param     item cJSON 对象
273.    * @param     buffer 已分配的缓冲区
274.    * @param     length 缓冲区长度
275.    * @param     format 是否格式化输出
276.    * @return    cJSON_bool 成功返回 1，失败返回 0
277.    * @note      调用者对缓冲区完全负责
278.    */
279.   CJSON_PUBLIC(cJSON_bool)  cJSON_PrintPreallocated(cJSON *item, char *buffer, const int length, const cJSON_bool format);
280.   /* Delete a cJSON entity and all subentities. */
281.   /**
282.    * @name      cJSON_Delete
283.    * @brief     删除 cJSON 对象及其所有子对象
284.    * @param     item cJSON 对象
285.    */
286.   CJSON_PUBLIC(void)  cJSON_Delete(cJSON *item);
288.   /* Returns the number of items in an array (or object). */
289.   /**
290.    * @name      cJSON_GetArraySize
291.    * @brief     返回数组（或对象）中的项数
292.    * @param     array cJSON 数组
293.    * @return    int 数组中的项数
294.    */
295.   CJSON_PUBLIC(int)  cJSON_GetArraySize(const cJSON *array);
297.   /* Retrieve item number "index" from array "array". Returns NULL if unsuccessful. */
298.   /**
299.    * @name      cJSON_GetArrayItem
300.    * @brief     从数组中检索指定索引的项
301.    * @param     array cJSON 数组
302.    * @param     index 索引
303.    * @return    cJSON* 检索到的项，失败返回 NULL
304.    */
305.   CJSON_PUBLIC(cJSON *)  cJSON_GetArrayItem(const cJSON *array, int index);
306.   /* Get item "string" from object. Case insensitive. */
308.   /**
309.    * @name      cJSON_GetObjectItem
310.    * @brief     从对象中获取指定名称的项（不区分大小写）
311.    * @param     object cJSON 对象
312.    * @param     string 项的名称
313.    * @return    cJSON* 检索到的项
314.    */
315.   CJSON_PUBLIC(cJSON *)  cJSON_GetObjectItem(const cJSON *const object, const char *const string);
316.   /**
317.    * @name      cJSON_GetObjectItemCaseSensitive
318.    * @brief     从对象中获取指定名称的项（区分大小写）
319.    * @param     object cJSON 对象
320.    * @param     string 项的名称
321.    * @return    cJSON* 检索到的项
322.    */
323.   CJSON_PUBLIC(cJSON *)  cJSON_GetObjectItemCaseSensitive(const cJSON *const object, const char *const string);
325.   /**
326.    * @name      cJSON_HasObjectItem
327.    * @brief     检查对象中是否存在指定名称的项
328.    * @param     object cJSON 对象
329.    * @param     string 项的名称
330.    * @return    cJSON_bool 存在返回 1，不存在返回 0
331.    */
332.   CJSON_PUBLIC(cJSON_bool)  cJSON_HasObjectItem(const cJSON *object, const char *string);
333.   /* For analysing failed parses. This returns a pointer to the parse error. You'll probably need to look a few chars back to make sense of it. Defined when cJSON_Parse() returns 0. 0 when cJSON_Parse() succeeds. */
335.   /**
336.    * @name      cJSON_GetErrorPtr
337.    * @brief     获取解析失败的错误指针
338.    * @return    const char* 错误指针
339.    */
340.   CJSON_PUBLIC(const char *)  cJSON_GetErrorPtr(void);
342.   /* Check item type and return its value */
343.   /**
344.    * @name      cJSON_GetStringValue
345.    * @brief     检查项类型并返回其字符串值
346.    * @param     item cJSON 项
347.    * @return    char* 字符串值
348.    */
349.   CJSON_PUBLIC(char *)  cJSON_GetStringValue(const cJSON *const item);
350.   /**
351.    * @name      cJSON_GetNumberValue
352.    * @brief     检查项类型并返回其数值
353.    * @param     item cJSON 项
354.    * @return    double 数值
355.    */
356.   CJSON_PUBLIC(double)  cJSON_GetNumberValue(const cJSON *const item);
358.   /* These functions check the type of an item */
359.   /* 以下函数检查项的类型 */
360.   CJSON_PUBLIC(cJSON_bool)  cJSON_IsInvalid(const cJSON *const item);
361.   CJSON_PUBLIC(cJSON_bool)  cJSON_IsFalse(const cJSON *const item);
362.   CJSON_PUBLIC(cJSON_bool)  cJSON_IsTrue(const cJSON *const item);
363.   CJSON_PUBLIC(cJSON_bool)  cJSON_IsBool(const cJSON *const item);
364.   CJSON_PUBLIC(cJSON_bool)  cJSON_IsNull(const cJSON *const item);
365.   CJSON_PUBLIC(cJSON_bool)  cJSON_IsNumber(const cJSON *const item);
366.   CJSON_PUBLIC(cJSON_bool)  cJSON_IsString(const cJSON *const item);
367.   CJSON_PUBLIC(cJSON_bool)  cJSON_IsArray(const cJSON *const item);
368.   CJSON_PUBLIC(cJSON_bool)  cJSON_IsObject(const cJSON *const item);
369.   CJSON_PUBLIC(cJSON_bool)  cJSON_IsRaw(const cJSON *const item);
371.   /* These calls create a cJSON item of the appropriate type. */
372.   /* 以下函数创建适当类型的 cJSON 项 */
373.   CJSON_PUBLIC(cJSON *)  cJSON_CreateNull(void);
374.   CJSON_PUBLIC(cJSON *)  cJSON_CreateTrue(void);
375.   CJSON_PUBLIC(cJSON *)  cJSON_CreateFalse(void);
376.   CJSON_PUBLIC(cJSON *)  cJSON_CreateBool(cJSON_bool boolean);
377.   CJSON_PUBLIC(cJSON *)  cJSON_CreateNumber(double num);
378.   CJSON_PUBLIC(cJSON *)  cJSON_CreateString(const char *string);
379.   /* raw json */
380.   /* 原始 JSON */
381.   CJSON_PUBLIC(cJSON *)  cJSON_CreateRaw(const char *raw);
382.   CJSON_PUBLIC(cJSON *)  cJSON_CreateArray(void);
383.   CJSON_PUBLIC(cJSON *)  cJSON_CreateObject(void);
385.   /* Create a string where valuestring references a string so
386.    * it will not be freed by cJSON_Delete */
387.   /**
388.    * @name      cJSON_CreateStringReference
389.    * @brief     创建一个字符串引用项，valuestring 引用一个字符串，因此不会被 cJSON_Delete 释放
390.    * @param     string 字符串
391.    * @return    cJSON* 创建的字符串引用项
392.    */
393.   CJSON_PUBLIC(cJSON *)  cJSON_CreateStringReference(const char *string);
394.   /* Create an object/array that only references it's elements so
395.    * they will not be freed by cJSON_Delete */
396.   /**
397.    * @name      cJSON_CreateObjectReference
398.    * @brief     创建一个对象引用项，引用其元素，因此不会被 cJSON_Delete 释放
399.    * @param     child 子对象
400.    * @return    cJSON* 创建的对象引用项
401.    */
402.   CJSON_PUBLIC(cJSON *)  cJSON_CreateObjectReference(const cJSON *child);
403.   /**
404.    * @name      cJSON_CreateArrayReference
405.    * @brief     创建一个数组引用项，引用其元素，因此不会被 cJSON_Delete 释放
406.    * @param     child 子数组
407.    * @return    cJSON* 创建的数组引用项
408.    */
409.   CJSON_PUBLIC(cJSON *)  cJSON_CreateArrayReference(const cJSON *child);
411.   /* These utilities create an Array of count items.
412.    * The parameter count cannot be greater than the number of elements in the number array, otherwise array access will be out of bounds.*/
413.   /**
414.    * @name      cJSON_CreateIntArray
415.    * @brief     创建一个包含整数数组的 cJSON 项
416.    * @param     numbers 整数数组
417.    * @param     count 数组元素数量
418.    * @return    cJSON* 创建的整数数组项
419.    * @note      参数 count 不能大于整数数组的元素数量，否则数组访问将越界
420.    */
421.   CJSON_PUBLIC(cJSON *)  cJSON_CreateIntArray(const int *numbers, int count);
422.   /**
423.    * @name      cJSON_CreateFloatArray
424.    * @brief     创建一个包含浮点数组的 cJSON 项
425.    * @param     numbers 浮点数组
426.    * @param     count 数组元素数量
427.    * @return    cJSON* 创建的浮点数组项
428.    * @note      参数 count 不能大于浮点数组的元素数量，否则数组访问将越界
429.    */
430.   CJSON_PUBLIC(cJSON *)  cJSON_CreateFloatArray(const float *numbers, int count);
431.   /**
432.    * @name      cJSON_CreateDoubleArray
433.    * @brief     创建一个包含双精度数组的 cJSON 项
434.    * @param     numbers 双精度数组
435.    * @param     count 数组元素数量
436.    * @return    cJSON* 创建的双精度数组项
437.    * @note      参数 count 不能大于双精度数组的元素数量，否则数组访问将越界
438.    */
439.   CJSON_PUBLIC(cJSON *)  cJSON_CreateDoubleArray(const double *numbers, int count);
440.   /**
441.    * @name      cJSON_CreateStringArray
442.    * @brief     创建一个包含字符串数组的 cJSON 项
443.    * @param     strings 字符串数组
444.    * @param     count 数组元素数量
445.    * @return    cJSON* 创建的字符串数组项
446.    * @note
447.    *
448.    */
449.   CJSON_PUBLIC(cJSON *)  cJSON_CreateStringArray(const char *const *strings, int count);
451.   /* Append item to the specified array/object. */
452.   /**
453.    * @name      cJSON_AddItemToArray
454.    * @brief     将项添加到指定的数组中
455.    * @param     array cJSON 数组
456.    * @param     item 要添加的项
457.    * @return    cJSON_bool 成功返回 1，失败返回 0
458.    */
459.   CJSON_PUBLIC(cJSON_bool)  cJSON_AddItemToArray(cJSON *array, cJSON *item);
460.   /*@name cJSON_AddItemToObject
461.    *@brief 将项添加到指定的对象中
462.    *@param object cJSON 对象
463.    *@param string 项的名称
464.    *@param item 要添加的项
465.    *@ return cJSON_bool 成功返回 1，失败返回 0 *
466.    */
467.   CJSON_PUBLIC(cJSON_bool)  cJSON_AddItemToObject(cJSON *object, const char *string, cJSON *item);
468.   /* Use this when string is definitely const (i.e. a literal, or as good as), and will definitely survive the cJSON object.
469.    * WARNING: When this function was used, make sure to always check that (item->type & cJSON_StringIsConst) is zero before
470.    * writing to `item->string` */
471.   /**
472.    * @name      cJSON_AddItemToObjectCS
473.    * @brief     将项添加到指定的对象中，当字符串是 const 时使用
474.    * @param     object cJSON 对象
475.    * @param     string 项的名称
476.    * @param     item 要添加的项
477.    * @return    cJSON_bool 成功返回 1，失败返回 0
478.    * @note      当使用此函数时，确保在写入 `item->string` 之前始终检查 (item->type & cJSON_StringIsConst) 是否为零
479.    */
480.   CJSON_PUBLIC(cJSON_bool)  cJSON_AddItemToObjectCS(cJSON *object, const char *string, cJSON *item);
481.   /* Append reference to item to the specified array/object. Use this when you want to add an existing cJSON to a new cJSON, but don't want to corrupt your existing cJSON. */
482.   /**
483.    * @name      cJSON_AddItemReferenceToArray
484.    * @brief     将项的引用添加到指定的数组中
485.    * @param     array cJSON 数组
486.    * @param     item 要添加的项
487.    * @return    cJSON_bool 成功返回 1，失败返回 0
488.    * @note      使用此函数时，您希望将现有的 cJSON 添加到新的 cJSON 中，但不希望破坏现有的 cJSON
489.    */
490.   CJSON_PUBLIC(cJSON_bool)  cJSON_AddItemReferenceToArray(cJSON *array, cJSON *item);
491.   /**
492.    * @name      cJSON_AddItemReferenceToObject
493.    * @brief     将项的引用添加到指定的对象中
494.    * @param     object cJSON 对象
495.    * @param     string 项的名称
496.    * @param     item 要添加的项
497.    * @return    cJSON_bool 成功返回 1，失败返回 0
498.    * @note      使用此函数时，您希望将现有的 cJSON 添加到新的 cJSON 中，但不希望破坏现有的 cJSON
499.    */
500.   CJSON_PUBLIC(cJSON_bool)  cJSON_AddItemReferenceToObject(cJSON *object, const char *string, cJSON *item);
502.   /* Remove/Detach items from Arrays/Objects. */
503.   /**
504.    * @name      cJSON_DetachItemViaPointer
505.    * @brief     从父对象中分离指定的项
506.    * @param     parent 父对象
507.    * @param     item 要分离的项
508.    * @return    cJSON* 分离的项
509.    */
510.   CJSON_PUBLIC(cJSON *)  cJSON_DetachItemViaPointer(cJSON *parent, cJSON *const item);
512.   /**
513.    * @name      cJSON_DetachItemFromArray
514.    * @brief     从数组中分离指定索引的项
515.    * @param     array cJSON 数组
516.    * @param     which 索引
517.    * @return    cJSON* 分离的项
518.    */
519.   CJSON_PUBLIC(cJSON *)  cJSON_DetachItemFromArray(cJSON *array, int which);
521.   /**
522.    * @name      cJSON_DeleteItemFromArray
523.    * @brief     从数组中删除指定索引的项
524.    * @param     array cJSON 数组
525.    * @param     which 索引
526.    */
527.   CJSON_PUBLIC(void)  cJSON_DeleteItemFromArray(cJSON *array, int which);
528.   /**
529.    * @name      cJSON_DetachItemFromObject
530.    * @brief     从对象中分离指定名称的项（不区分大小写）
531.    * @param     object cJSON 对象
532.    * @param     string 项的名称
533.    * @return    cJSON* 分离的项
534.    */
535.   CJSON_PUBLIC(cJSON *)  cJSON_DetachItemFromObject(cJSON *object, const char *string);
536.   /**
537.    * @name      cJSON_DetachItemFromObjectCaseSensitive
538.    * @brief     从对象中分离指定名称的项（区分大小写）
539.    * @param     object cJSON 对象
540.    * @param     string 项的名称
541.    * @return    cJSON* 分离的项
542.    */
543.   CJSON_PUBLIC(cJSON *)  cJSON_DetachItemFromObjectCaseSensitive(cJSON *object, const char *string);
544.   /**
545.    * @name      cJSON_DeleteItemFromObject
546.    * @brief     从对象中删除指定名称的项（不区分大小写）
547.    * @param     object cJSON 对象
548.    * @param     string 项的名称
549.    */
550.   CJSON_PUBLIC(void)  cJSON_DeleteItemFromObject(cJSON *object, const char *string);
551.   /**
552.    * @name      cJSON_DeleteItemFromObjectCaseSensitive
553.    * @brief     从对象中删除指定名称的项（区分大小写）
554.    * @param     object cJSON 对象
555.    * @param     string 项的名称
556.    */
557.   CJSON_PUBLIC(void)  cJSON_DeleteItemFromObjectCaseSensitive(cJSON *object, const char *string);
559.   /* Update array items. */
560.   /**
561.    * @name      cJSON_InsertItemInArray
562.    * @brief     在数组中插入项，将现有项右移
563.    * @param     array cJSON 数组
564.    * @param     which 插入位置的索引
565.    * @param     newitem 新项
566.    * @return    cJSON_bool 成功返回 1，失败返回 0
567.    */
568.   CJSON_PUBLIC(cJSON_bool)  cJSON_InsertItemInArray(cJSON *array, int which, cJSON *newitem); /* Shifts pre-existing items to the right. */
569.   /**
570.    * @name      cJSON_ReplaceItemViaPointer
571.    * @brief     用新项替换父对象中的指定项
572.    * @param     parent 父对象
573.    * @param     item 要替换的项
574.    * @param     replacement 新项
575.    * @return    cJSON_bool 成功返回 1，失败返回 0
576.    */
577.   CJSON_PUBLIC(cJSON_bool)  cJSON_ReplaceItemViaPointer(cJSON *const parent, cJSON *const item, cJSON *replacement);
578.   /**
579.    * @name      cJSON_ReplaceItemInArray
580.    * @brief     用新项替换数组中指定索引的项
581.    * @param     array cJSON 数组
582.    * @param     which 索引
583.    * @param     newitem 新项
584.    * @return    cJSON_bool 成功返回 1，失败返回 0
585.    */
586.   CJSON_PUBLIC(cJSON_bool)  cJSON_ReplaceItemInArray(cJSON *array, int which, cJSON *newitem);
587.   /**
588.    * @name      cJSON_ReplaceItemInObject
589.    * @brief     用新项替换对象中指定名称的项（不区分大小写）
590.    * @param     object cJSON 对象
591.    * @param     string 项的名称
592.    * @param     newitem 新项
593.    * @return    cJSON_bool 成功返回 1，失败返回 0
594.    */
595.   CJSON_PUBLIC(cJSON_bool)  cJSON_ReplaceItemInObject(cJSON *object, const char *string, cJSON *newitem);
596.   /**
597.    * @name      cJSON_ReplaceItemInObjectCaseSensitive
598.    * @brief     用新项替换对象中指定名称的项（区分大小写）
599.    * @param     object cJSON 对象
600.    * @param     string 项的名称
601.    * @param     newitem 新项
602.    * @return    cJSON_bool 成功返回 1，失败返回 0
603.    */
604.   CJSON_PUBLIC(cJSON_bool)  cJSON_ReplaceItemInObjectCaseSensitive(cJSON *object, const char *string, cJSON *newitem);
606.   /* Duplicate a cJSON item */
607.   /**
608.    * @name      cJSON_Duplicate
609.    * @brief     复制一个 cJSON 项
610.    * @param     item 要复制的项
611.    * @param     recurse 是否递归复制子项
612.    * @return    cJSON* 复制后的项
613.    * @note      复制将创建一个新的、与传递的项相同的 cJSON 项，在新内存中，需要释放。
614.    *            当 recurse!=0 时，它将复制连接到该项的任何子项。返回的项的 item->next 和 ->prev 指针始终为零。
615.    */
616.   CJSON_PUBLIC(cJSON *)  cJSON_Duplicate(const cJSON *item, cJSON_bool recurse);
617.   /* Duplicate will create a new, identical cJSON item to the one you pass, in new memory that will
618.    * need to be released. With recurse!=0, it will duplicate any children connected to the item.
619.    * The item->next and ->prev pointers are always zero on return from Duplicate. */
620.   /* Recursively compare two cJSON items for equality. If either a or b is NULL or invalid, they will be considered unequal.
621.    * case_sensitive determines if object keys are treated case sensitive (1) or case insensitive (0) */
622.   /**
623.    * @name      cJSON_Compare
624.    * @brief     递归比较两个 cJSON 项是否相等。如果 a 或 b 为 NULL 或无效，它们将被视为不相等。
625.    * @param     a 第一个 cJSON 项
626.    * @param     b 第二个 cJSON 项
627.    * @param     case_sensitive 是否区分大小写
628.    * @return    cJSON_bool 相等返回 1，不相等返回 0
629.    */
630.   CJSON_PUBLIC(cJSON_bool)  cJSON_Compare(const cJSON *const a, const cJSON *const b, const cJSON_bool case_sensitive);
632.   /* Minify a strings, remove blank characters(such as ' ', '\t', '\r', '\n') from strings.
633.    * The input pointer json cannot point to a read-only address area, such as a string constant,
634.    * but should point to a readable and writable address area. */
635.   /**
636.    * @name      cJSON_Minify
637.    * @brief     压缩字符串，去除字符串中的空白字符（如 ' ', '\t', '\r', '\n'）
638.    * @param     json 要压缩的字符串
639.    * @note      输入指针 json 不能指向只读地址区域，如字符串常量，而应指向可读写的地址区域。
640.    */
641.   CJSON_PUBLIC(void)  cJSON_Minify(char *json);
643.   /* Helper functions for creating and adding items to an object at the same time.
644.    * They return the added item or NULL on failure. */
646.   /**
647.    * @name      cJSON_AddNullToObject
648.    * @brief     创建并添加一个空项到对象中
649.    * @param     object cJSON 对象
650.    * @param     name 项的名称
651.    * @return    cJSON* 添加的项，失败返回 NULL
652.    */
653.   CJSON_PUBLIC(cJSON *)  cJSON_AddNullToObject(cJSON *const object, const char *const name);
654.   /**
655.    * @name      cJSON_AddTrueToObject
656.    * @brief     创建并添加一个 true 项到对象中
657.    * @param     object cJSON 对象
658.    * @param     name 项的名称
659.    * @return    cJSON* 添加的项，失败返回 NULL
660.    */
661.   CJSON_PUBLIC(cJSON *)  cJSON_AddTrueToObject(cJSON *const object, const char *const name);
662.   /**
663.    * @name      cJSON_AddFalseToObject
664.    * @brief     创建并添加一个 false 项到对象中
665.    * @param     object cJSON 对象
666.    * @param     name 项的名称
667.    * @return    cJSON* 添加的项，失败返回 NULL
668.    */
669.   CJSON_PUBLIC(cJSON *)  cJSON_AddFalseToObject(cJSON *const object, const char *const name);
670.   /**
671.    * @name      cJSON_AddBoolToObject
672.    * @brief     创建并添加一个布尔项到对象中
673.    * @param     object cJSON 对象
674.    * @param     name 项的名称
675.    * @param     boolean 布尔值
676.    * @return    cJSON* 添加的项，失败返回 NULL
677.    */
678.   CJSON_PUBLIC(cJSON *)  cJSON_AddBoolToObject(cJSON *const object, const char *const name, const cJSON_bool boolean);
679.   /**
680.    * @name      cJSON_AddNumberToObject
681.    * @brief     创建并添加一个数字项到对象中
682.    * @param     object cJSON 对象
683.    * @param     name 项的名称
684.    * @param     number 数值
685.    * @return    cJSON* 添加的项，失败返回 NULL
686.    */
687.   CJSON_PUBLIC(cJSON *)  cJSON_AddNumberToObject(cJSON *const object, const char *const name, const double number);
688.   /**
689.    * @name      cJSON_AddStringToObject
690.    * @brief     创建并添加一个字符串项到对象中
691.    * @param     object cJSON 对象
692.    * @param     name 项的名称
693.    * @param     string 字符串值
694.    * @return    cJSON* 添加的项，失败返回 NULL
695.    */
696.   CJSON_PUBLIC(cJSON *)  cJSON_AddStringToObject(cJSON *const object, const char *const name, const char *const string);
697.   /**
698.    * @name      cJSON_AddRawToObject
699.    * @brief     创建并添加一个原始 JSON 项到对象中
700.    * @param     object cJSON 对象
701.    * @param     name 项的名称
702.    * @param     raw 原始 JSON 字符串
703.    * @return    cJSON* 添加的项，失败返回 NULL
704.    */
705.   CJSON_PUBLIC(cJSON *)  cJSON_AddRawToObject(cJSON *const object, const char *const name, const char *const raw);
707.   /**
708.    * @name      cJSON_AddObjectToObject
709.    * @brief     创建并添加一个对象项到对象中
710.    * @param     object cJSON 对象
711.    * @param     name 项的名称
712.    * @return    cJSON* 添加的项，失败返回 NULL
713.    */
714.   CJSON_PUBLIC(cJSON *)  cJSON_AddObjectToObject(cJSON *const object, const char *const name);
715.   /**
716.    * @name      cJSON_AddArrayToObject
717.    * @brief     创建并添加一个数组项到对象中
718.    * @param     object cJSON 对象
719.    * @param     name 项的名称
720.    * @return    cJSON* 添加的项，失败返回 NULL
721.    */
722.   CJSON_PUBLIC(cJSON *)  cJSON_AddArrayToObject(cJSON *const object, const char *const name);
724. /* When assigning an integer value, it needs to be propagated to valuedouble too. */
725. #define cJSON_SetIntValue(object, number) ((object) ? (object)->valueint = (object)->valuedouble = (number) : (number))
726.   /* helper for the cJSON_SetNumberValue macro */
727.   /**
728.    * @name      cJSON_SetNumberHelper
729.    * @brief     帮助宏 cJSON_SetNumberValue 设置数值
730.    * @param     object cJSON 对象
731.    * @param     number 数值
732.    * @return    double 设置后的数值
733.    */
734.   CJSON_PUBLIC(double)  cJSON_SetNumberHelper(cJSON *object, double number);
735. #define cJSON_SetNumberValue(object, number) ((object != NULL) ? cJSON_SetNumberHelper(object, (double)number) : (number))
736.   /* Change the valuestring of a cJSON_String object, only takes effect when type of object is cJSON_String */
737.   /**
738.    * @name      cJSON_SetValuestring
739.    * @brief     更改 cJSON_String 对象的 valuestring 值，仅当对象类型为 cJSON_String 时生效
740.    * @param     object cJSON 对象
741.    * @param     valuestring 新的字符串值
742.    * @return    char* 更改后的字符串
743.    */
744.   CJSON_PUBLIC(char *)  cJSON_SetValuestring(cJSON *object, const char *valuestring);
746. /* If the object is not a boolean type this does nothing and returns cJSON_Invalid else it returns the new type*/
747. #define cJSON_SetBoolValue(object, boolValue) ( \
748.     (object != NULL && ((object)->type & (cJSON_False | cJSON_True))) ? (object)->type = ((object)->type & (~(cJSON_False | cJSON_True))) | ((boolValue) ? cJSON_True : cJSON_False) : cJSON_Invalid)
750. /* Macro for iterating over an array or object */
751. /* */
752. /*  */
753. /**
754. * 用于在数组或对象上迭代的宏 , 用于遍历一个cJSON数组中的每一个元素
755. *
756. * element 是当前遍历到的cJSON元素.
757. * array 是需要遍历的cJSON数组。
758. * for 循环的初始化部分：element = (array != NULL) ? (array)->child : NULL，如果 array 非空，则将 element 初始化为 array 的第一个子元素，否则初始化为 NULL。
759. * 循环的条件部分：element != NULL，只要 element 不为空，循环就会继续。
760. * 循环的迭代部分：element = element->next，将 element 更新为下一个兄弟元素。
761. */
762. #define cJSON_ArrayForEach(element, array) for (element = (array != NULL) ? (array)->child : NULL; element != NULL; element = element->next)
764.   /* malloc/free objects using the malloc/free functions that have been set with cJSON_InitHooks */
765.   /**
766.    * @name      cJSON_malloc
767.    * @brief     使用已经设置的 malloc 函数分配内存
768.    * @param     size 内存大小
769.    * @return    void* 分配的内存指针
770.    */
771.   CJSON_PUBLIC(void *)  cJSON_malloc(size_t size);
772.   /**
773.    * @name      cJSON_free
774.    * @brief     使用已经设置的 free 函数释放内存
775.    * @param     object 要释放的内存指针
776.    */
777.   CJSON_PUBLIC(void)  cJSON_free(void *object);
779. #ifdef __cplusplus
780. }
781. #endif
783. #endif
784. // clang-format on

复制代码

cJSON.c

DaveGamble/cJSON: Ultralightweight JSON parser in ANSI C (github.com)  cJSON库 基于C语言的一个开源项目
去这里下载cJSON.c文件及原版cJSON.h文件.
参考链接

• 心知服务的说明
  
• 新知天气城市列表
  
• DaveGamble/cJSON: Ultralightweight JSON parser in ANSI C (github.com)  cJSON库 基于C语言的一个开源项目
  

测试链接:

1. 未来天气
2. https://api.seniverse.com/v3/weather/daily.json?key=你的私钥&location=guangzhou&language=en&unit=c&start=0&days=3
3. 实况天气
4. https://api.seniverse.com/v3/weather/now.json?key=你的私钥&location=guangzhou&language=en&unit=c

复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。