簡介
Jansson是一個用於解碼、編碼、操控JSON的C庫。其特性為：
- 簡單直觀的API和數據模型
- 沒有依賴項
- 完整的Unicode支持（UTF-8）
構建
Jansson使用cmake作為構建工具。可以執行下面的命令構建：
|
1
2
3
4
5
|
git clone https://github.com/akheron/jansson
cd jansson
mkdir build && cd build
cmake -DCMAKE_INSTALL_PREFIX:STRING=/home/alex/CPP/lib/jansson/2.9 -DJANSSON_BUILD_DOCS=OFF ..
cmake --build . -- install
|
上述命令執行后，Jansson的頭文件和靜態庫被安裝到/home/alex/CPP/lib/jansson/2.9目錄
使用
這里我們創建一個CMake工程：
|
1
2
3
4
5
6
7
|
cmake_minimum_required(VERSION 3.6)
project(jansson_demo C)
set(SOURCE_FILES main.c)
include_directories(/home/alex/CPP/lib/jansson/2.9/include)
add_executable(jansson_demo ${SOURCE_FILES})
set_property(TARGET jansson_demo PROPERTY C_STANDARD 99)
target_link_libraries(jansson_demo /home/alex/CPP/lib/jansson/2.9/lib/libjansson.a)
|
解碼JSON
下面的代碼展示了如何把字符串解碼為json_t結構：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
|
#include <jansson.h>
#include <assert.h>
int main() {
char *text = "{ \"name\":\"汪震\", \"age\":30, \"children\":[ \"彩彩\", \"當當\" ] }";
json_error_t error;
// json_t用於引用任何JSON節點
json_t *root = json_loads( text, 0, &error );
// 如果讀取失敗，自動置為空指針
if ( !root ) {
fprintf( stderr, "error: on line %d: %s\n", error.line, error.text );
return 1;
} else {
// json_is_*宏用於判斷數據類型
// 處理JSON對象
assert( json_is_object( root ));
json_t *name, *age, *children;
name = json_object_get( root, "name" );
age = json_object_get( root, "age" );
fprintf( stdout, "NAME: %s, AGE: %d\n", json_string_value( name ), json_integer_value( age ));
children = json_object_get( root, "children" );
// 處理JSON數組
assert( json_is_array( children ));
int sof = json_array_size( children );
for ( int i = 0; i != sof; i++ ) {
json_t *child = json_array_get( children, i );
fprintf( stdout, "CHILDREN: %s\n", json_string_value( child ));
}
// 減小引用計數，導致資源回收
json_decref( root );
}
return 0;
}
|
運行上述代碼后輸出：
|
1
2
3
|
NAME: 汪震, AGE: 30
CHILDREN: 彩彩
CHILDREN: 當當
|
編碼JSON
下面的代碼展示了如何把json_t結構編碼為字符串：
|
1
2
3
|
json_t *root = json_pack( "{sssis[ss]}", "name", "汪震", "age", 30, "children", "彩彩", "當當" );
char *text = json_dumps( root, JSON_INDENT( 4 ) | JSON_SORT_KEYS );
fprintf( stdout, "%s\n", text );
|
運行上述代碼后輸出：
|
1
2
3
4
5
6
7
8
|
{
"age": 30,
"children": [
"彩彩",
"當當"
],
"name": "汪震"
}
|
打包JSON
下面的代碼展示了如何把零散數據打包（pack）為json_t結構：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
|
assert( json_is_integer( json_pack( "i", 1 )));
assert( json_is_array(
// jansson使用格式限定符來指定要創建的JSON的JSON節點的類型
// 下面的例子創建三元素的數組：字符串、字符串、布爾值
json_pack( "[ssb]", "foo", "bar", 1 )
));
/* 打包一個空對象 */
json_pack( "{}" );
/* 打包出 {age:30,childNum:2} */
json_pack( "{sisi}", "age", 30, "childNum", 2 );
/* 打包出 [[1, 2], {"num": true}] */
json_pack( "[[i,i],{s:b}]", 1, 2, "num", 1 );
return 0;
|
可用的格式限定符如下表：
| 限定符 | 說明 |
| s | 將null結尾的UTF-8字符串轉換為JSON字符串 |
| s? | 和上面類似，但是如果位置參數是NULL則插入JSON null值 |
| s# | 對應兩個位置參數const char *, int，將指定長度的UTF-8緩沖轉換為JSON字符串 |
| s% | 和上面類似，只是未知參數類型為const char *, size_t |
| + | 把此位置參數連接到前一個位置參數后面 |
| +# | 和上面類似，接收位置參數const char *, int |
| +% | 和上面類似，接收位置參數const char *, size_t |
| n | 輸出null，不消耗位置參數 |
| b | 轉換int為JSON布爾值 |
| i | 轉換int為JSON整數 |
| I | 轉換json_int_t為JSON整數 |
| f | 轉換double為JSON實數 |
| o | 原樣插入json_t*結構 |
| O | 和上面類似，但是目標json_t的引用計數會增加 |
| o? o? | 類似上面兩個，但是當位置參數為NULL時插入null |
| [fmt] | 使用內部的格式限定符構建一個JSON數組，fmt可以是任意符合要求的格式限定符序列 |
| {fmt} | 使用內部的格式限定符構建一個JSON對象，fmt可以是任意符合要求的格式限定符序列 |
解包JSON
下面的代碼展示了如何把json_t結構解包為零散數據：
|
1
2
3
4
5
6
|
json_t *root = json_pack( "{sssis[ss]}", "name", "汪震", "age", 30, "children", "彩彩", "當當" );
char *name;
int age;
// 可以僅僅解包一部分
json_unpack( root, "{sssi}", "name", &name, "age", &age );
fprintf( stdout, "NAME: %s, AGE:%d\n", name, age );
|