解剖cJson的parse_string（四）：一步步解析字符串的玄机

2023-01-17 05:00:50

深入剖析cJson库：Parse String函数

在处理JSON数据时，解析字符串是至关重要的任务。cJSON库为我们提供了parse_string函数，它可以将JSON格式的字符串解析为cJSON结构。本文将深入探讨parse_string函数的工作原理，涵盖JSON字符串的语法要求、转义字符的用法以及Unicode字符的处理。

JSON字符串的语法要求

1. 双引号： JSON字符串必须使用双引号（"）包裹。

2. 转义字符： 某些特殊字符，例如双引号、反斜杠等，在JSON字符串中需要使用转义字符表示。

3. 控制字符： JSON字符串不能包含控制字符，如换行符、制表符等。

4. Unicode字符： JSON字符串可以包含Unicode字符，但必须使用转义序列表示。

转义字符

转义字符	说明
\b	退格符
\f	换页符
\n	换行符
\r	回车符
\t	制表符
\	反斜杠
"	双引号
/	正斜杠

Unicode、UTF-8和UTF-16

Unicode是一种字符编码标准，可表示世界上所有语言的字符。UTF-8和UTF-16是Unicode的两种编码方式，分别使用1-4个字节和2-4个字节表示一个Unicode字符。

代理对

为了表示超过65535的Unicode字符，需要使用代理对，即高代理对和低代理对，分别表示字符的高10位和低10位。

测试用例和源码小bug

parse_string函数通过一系列测试用例进行验证，确保其可以正确解析各种类型的字符串。但在解析代理对时，存在一个小bug，导致无法正确解析某些类型的字符串。

cJSON库中的Parse String函数

函数签名：

cJSON *cJSON_ParseString(const char *str)

参数：

str：要解析的JSON字符串

返回值：

如果解析成功，返回一个指向解析结果的cJSON结构体的指针；否则返回NULL。

代码示例

#include <stdio.h>
#include "cJSON.h"

int main() {
    const char *json_str = "{\"name\": \"John Doe\", \"age\": 30}";
    cJSON *json = cJSON_ParseString(json_str);

    if (json) {
        cJSON *name = cJSON_GetObjectItem(json, "name");
        cJSON *age = cJSON_GetObjectItem(json, "age");

        printf("Name: %s\n", name->valuestring);
        printf("Age: %d\n", age->valueint);
    } else {
        printf("Error parsing JSON string.\n");
    }

    cJSON_Delete(json);
    return 0;
}