README.md · sx_5431/libjson - Gitee.com

forked from 风尘叹/libjson

加入 Gitee

与超过 1200万开发者一起发现、参与优秀开源项目，私有仓库也完全免费：）

文件

该仓库未声明开源许可证文件（LICENSE），使用请关注具体项目描述及其代码上游依赖。

克隆/下载

README.md 2.12 KB

# libjson

libjson 是一款简单、高性能的 C 语言 json 库，以 LGPL 协议发布。

libjson 支持以 SAX 模式进行解析，也支持以 DOM 模式解析。

libjson 以非常节制的方式使用内存。以 SAX 模式进行解析时，libjson 不动态分配任何内存。以 DOM 模式进行解析和序列化时，libjson 仅为每个节点分配 20 字节（32 位系统）或 32 字节（64 位系统）内存（字符串本身占用的空间除外）。

libjson 本身是线程安全的。但是如果使用 SAX 模式进行解析，需要自行保证传入的回调函数线程安全。

libjson 目前使用递归方式生成与解析 json 文本，所以如果 json 对象的嵌套层数过深，可能会导致堆栈溢出。

## 数据类型与精度限制

libjson 对字符串存在长度限制，对数值存在精度限制。

在任何系统下，libjson 在解析时使用 double 类型变量存储浮点数，使用 long long int 类型变量存储整数。如果被解析的 json 字符串超过了这个限制，解析获得的数值将不正确，但 libjson 目前并不会因此而返回任何错误。

### 32 位系统
name 长度不能超过 255 个字节（8 位），value 字符串长度不能超过 65535 个字节（16 位）。如果被解析的 json 字符串超过了这个限制，则会发生高位截断。但 libjson 目前并不会因此而返回任何错误。

例如，如果某一个 name 的长度为 300，那么 300 会被截断为 44。

### 64 位系统
name 长度不能超过 262143 个字节（18 位），value 字符串长度不能超过 274877906943 个字节（38 位）。如果被解析的 json 字符串超过了这个限制，则会发生高位截断。但 libjson 目前并不会因此而返回任何错误。

## 编译

```
make -f nbproject/Makefile-Release.mk QMAKE= SUBPROJECTS= .build-conf
```

## 测试

```
make -f nbproject/Makefile-Release.mk SUBPROJECTS= .build-tests-conf
```

### 解析测试

```
./build/Release/GNU-Linux-x86/tests/TestFiles/f1 ./tests/test.json 1 p
```

### 性能测试

```
time ./build/Release/GNU-Linux-x86/tests/TestFiles/f1 ./tests/test.json 1000000 n
```

一键复制编辑原始数据按行查看历史

提交于 2015-12-02 20:39 . Change: 更新了 README

# libjson

libjson 是一款简单、高性能的 C 语言 json 库，以 LGPL 协议发布。

libjson 支持以 SAX 模式进行解析，也支持以 DOM 模式解析。

libjson 以非常节制的方式使用内存。以 SAX 模式进行解析时，libjson 不动态分配任何内存。以 DOM 模式进行解析和序列化时，libjson 仅为每个节点分配 20 字节（32 位系统）或 32 字节（64 位系统）内存（字符串本身占用的空间除外）。

libjson 本身是线程安全的。但是如果使用 SAX 模式进行解析，需要自行保证传入的回调函数线程安全。

libjson 目前使用递归方式生成与解析 json 文本，所以如果 json 对象的嵌套层数过深，可能会导致堆栈溢出。

## 数据类型与精度限制

libjson 对字符串存在长度限制，对数值存在精度限制。

在任何系统下，libjson 在解析时使用 double 类型变量存储浮点数，使用 long long int 类型变量存储整数。如果被解析的 json 字符串超过了这个限制，解析获得的数值将不正确，但 libjson 目前并不会因此而返回任何错误。

### 32 位系统
name 长度不能超过 255 个字节（8 位），value 字符串长度不能超过 65535 个字节（16 位）。如果被解析的 json 字符串超过了这个限制，则会发生高位截断。但 libjson 目前并不会因此而返回任何错误。

例如，如果某一个 name 的长度为 300，那么 300 会被截断为 44。

### 64 位系统
name 长度不能超过 262143 个字节（18 位），value 字符串长度不能超过 274877906943 个字节（38 位）。如果被解析的 json 字符串超过了这个限制，则会发生高位截断。但 libjson 目前并不会因此而返回任何错误。

## 编译

```
make -f nbproject/Makefile-Release.mk QMAKE= SUBPROJECTS= .build-conf
```

## 测试

```
make -f nbproject/Makefile-Release.mk SUBPROJECTS= .build-tests-conf
```

### 解析测试

```
./build/Release/GNU-Linux-x86/tests/TestFiles/f1 ./tests/test.json 1 p
```

### 性能测试

```
time ./build/Release/GNU-Linux-x86/tests/TestFiles/f1 ./tests/test.json 1000000 n
```

Loading...

马建仓 AI 助手

尝试更多

代码解读

代码找茬

代码优化

C

1

https://gitee.com/sx_543100/libjson.git

[email protected]:sx_543100/libjson.git

sx_543100

libjson

libjson

master