概述
cJSON是符合ANSI C標準的極輕量級JSON解析器。
版權說明
The MIT License
目錄結構
├── src
│ ├── cJSON.c # 源文件（必需）
│ └── cJPath.c # 源文件（必需）
├── include
│ └── cJSON.h # 包含cJSON API
├── package.yaml # 編譯配置文件
└── example
└── cjson_example.c # 示例代碼（默認禁用，可在package.yaml中使能）依賴組件
osal_aos
常用配置
無。
API說明
將字符串解析為JSON結構體
cJSON *cJSON_Parse(const char *value);args | description |
value | JSON字符串 |
刪除JSON結構體
void cJSON_Delete(cJSON *c);args | description |
value | 待刪除的JSON結構體 |
獲取JSON數組包含成員個數
int cJSON_GetArraySize(const cJSON *array);args | description |
value | 數組類型的JSON結構體 |
獲取JSON數組成員
cJSON *cJSON_GetArrayItem(const cJSON *array, int index);args | description |
array | 數組類型的JSON結構體 |
index | 數組成員索引 |
獲取JSON對象成員
cJSON *cJSON_GetObjectItemCaseSensitive(const cJSON * const object, const char * const string);args | description |
object | 對象類型的JSON結構體 |
string | 成員名稱（大小寫敏感） |
獲取出錯信息
const char *cJSON_GetErrorPtr(void);判斷JSON結構體是否為布爾類型
cJSON_bool cJSON_IsBool(const cJSON * const item);args | description |
item | 待判斷的JSON結構體 |
判斷JSON結構體是否為數值類型
cJSON_bool cJSON_IsNumber(const cJSON * const item);args | description |
item | 待判斷的JSON結構體 |
判斷JSON結構體是否為字符串類型
cJSON_bool cJSON_IsString(const cJSON * const item);args | description |
item | 待判斷的JSON結構體 |
判斷JSON結構體是否為數組類型
cJSON_bool cJSON_IsArray(const cJSON * const item);args | description |
item | 待判斷的JSON結構體 |
判斷JSON結構體是否為對象類型
cJSON_bool cJSON_IsObject(const cJSON * const item);args | description |
item | 待判斷的JSON結構體 |
使用示例
組件使用示例相關的代碼下載、編譯和固件燒錄均依賴AliOS Things配套的開發工具，所以首先需要參考《AliOS Things集成開發環境使用說明之搭建開發環境》，下載安裝。待開發環境搭建完成后，可以按照以下步驟進行示例的測試。
步驟1 創建或打開工程
打開已有工程
如果用于測試的案例工程已存在，可參考《AliOS Things集成開發環境使用說明之打開工程》打開已有工程。
創建新的工程
組件的示例代碼可以通過編譯鏈接到AliOS Things的任意案例（solution）來運行，這里選擇helloworld_demo案例。helloworld_demo案例相關的源代碼下載可參考《AliOS Things集成開發環境使用說明之創建工程》。
步驟2 添加組件
案例下載完成后，需要在helloworld_demo組件的package.yaml中添加對組件的依賴：
depends:
- cjson: maste步驟3 下載組件
在已安裝了的開發環境工具欄中，選擇Terminal -> New Terminal啟動終端，并且默認工作路徑為當前工程的workspace，此時在終端命令行中輸入：
aos install cjson上述命令執行成功后，組件源碼則被下載到了./components/cjson路徑中。
步驟5 編譯固件
在示例代碼已經添加至組件的配置文件，并且helloworld_demo已添加了對該組件的依賴后，就可以編譯helloworld_demo案例來生成固件了，具體編譯方法可參考《AliOS Things集成開發環境使用說明之編譯固件》。
步驟6 燒錄固件
helloworld_demo案例的固件生成后，可參考《AliOS Things集成開發環境使用說明之燒錄固件》來燒錄固件。
步驟7 打開串口
固件燒錄完成后，可以通過串口查看示例的運行結果，打開串口的具體方法可參考《AliOS Things集成開發環境使用說明之查看日志》。
當串口終端打開成功后，可在串口中輸入help來查看已添加的測試命令。
步驟8 測試示例
CLI命令行輸入：
cjson_example關鍵日志CLI日志：
Checking monitor "Awesome 4K"
1280 x 720.00
1920 x 1080.00
3840 x 2160.00