没有合适的资源？快使用搜索试试~ 我知道了~

文库首页后端CjanssonAPI翻译

janssonAPI翻译

Jansson

json

cjson

4星 · 超过85%的资源需积分: 16 120 下载量 114 浏览量 2013-06-29 16:31:25 上传评论 1 收藏 336KB DOC 举报

温馨提示

试读

27页

Jansson开发文档，主要API翻译，有jansson官方下载后翻译。jansson虽然功能强大但是不如cjson容易，所以将文档翻译了一下。

资源推荐

资源详情

资源评论

Jansson API 参考（仅供参考）

一、准备

所有的函数功能都在 jansson.h 里面，所以：

请包涵：

#incluede <jansson.h>

所有常数前缀都是用 JSON_开头（描述 library 版本信息由 JANSSON_引导）

其他的标示符有 json_开始。

类型的后缀是_t。

二、库的版本（略）

三、参数表示

由于 JSON 规格书中定义的数据类型：object, array, string, number, boolean, and

null.

并且 JSON 中的数据类型正在不断的扩充，所以哦，我们把所有的类型都放在一个 C type

里面，而且这个结构体包含所有 json 类型

Json_t

Value Representation

Json 类型：object,array,string,number,boolean, andnull.

json_t 包含所有 json 数据类型

如果发生错误，除非另有说明，所有的 API 函数返回一个错误值。

根据函数的原型，Error Value 是 NULL 或-1。无效的参数或输入无效的错误是

显而易见的来源。内存分配和 I / O 操作也可能会导致错误。

TYPE

使用以下功能查询和测试一个 JSON 值类型：

enumjson_type

JSON_OBJECT

JSON_ARRAY

JSON_STRING

JSON_INTEGER

JSON_REAL

JSON_TRUE

JSON_FALSE

JSON_NULL

这些对应的 JSON 对象，数组，字符串，数字，布尔和 null。其中 number 代表了的不同的 json

type，JSON_INTEGER 或 JSON_REAL 的任何一个值。一个真正的布尔值，表示由一个值的类

型 JSON_TRUE 和假值类型 JSON_FALSE。

intjson_typeof(constjson_t*json)
返回 JSON 值的类型（的 json_type 转换为 int）。JSON
不能为 null。这个功能实际上是作为宏观调控的速度实现。
json_is_object(constjson_t*json)
json_is_array(constjson_t*json)
json_is_string(constjson_t*json)
json_is_integer(constjson_t*json)
json_is_real(constjson_t*json)
json_is_true(constjson_t*json)
json_is_false(constjson_t*json)
json_is_null(constjson_t*json)
该函数功能是非零类型返回 true，零或空返回 false
json_is_number(constjson_t*json)
为¡JSON_INTEGER 或者 JSON_REAL 返回 true，false 则是其他类型或
者 NULL
json_is_boolean(constjson_t*json)
Returns   true   for   typesJSON_TRUEandJSON_FALSE,   and   false   for
values of other types and forNULL. 
Reference Count（引用计数）
引用计数是用来跟踪某个值是否仍然是在使用或不使用。
当创建一个值，它的引用计数设置为 1。如果参考值保持（如值存储供
以后使用的地方），其引用计数递增，并且不再需要该值时，引用计数
递减。
当引用计数下降到零，没有留下的引用，可以被摧毁的价值。
以下函数用于处理的引用计数。

json_t*json_incref(json_t*json)

如果它不是非 NULL，增加 JSON 的引用计数。最终返回 JSON。

voidjson_decref(json_t*json)

递减 JSON 引用计数。只要一旦调用以 json_decref（）后，引用计数下

降到零时，该值被破坏，不能再被使用。

函数创建新的 JSON 并把引用计数值设置为 1。这些函数被调用返回一

个新的引用。其他函数返回的 JSON 值（现有的），通常不会增加引用

计数。这些函数被调用，归还借用的参考。因此，如果用户将持有参考

返回借来的参考值，他必须调用 json_incref()。值一旦不再需要，应该

被称为 json_decref()释放引用。

通常情况下，所有函数的接受一个 JSON 作为参数值将管理引用，即增

加和减小所需要的引用计数作。但是，某些函数窃取引用，也就是说，

如果用户被调用 json_decref()后调用函数的参数，它们有相同的结果。

这些函数是后缀_new 或者有_new_的某处他们的名字。

例如，下面的代码创建了一个新的 JSON 数组并追加一个整数：

json_t *array, *integer;

array = json_array();

integer = json_integer(42);

json_array_append(array, integer);

json_decref(integer);

注意如何调用者的整数的值通过调用 json_decref（）释放参考。通过使

用参考盗取函数 json_array_append_new （）而不是

json_array_append（），代码变得简单得多：

json_t *array = json_array();

json_array_append_new(array, json_integer(42));

在这种情况下，用户不具有明确地释放为整数值，，作为

json_array_append_new（）窃取时的参考值附加到数组。

在下面的章节中明确记载是否函数会返回一个新的或借来的参考，或窃

取其参数的引用。

Circular References¶

A circular reference is created when an object or an array is, directly or

indirectly, inserted inside itself. The direct case is simple:

json_t *obj = json_object();

json_object_set(obj, "foo", obj);

Jansson will refuse to do this, andjson_object_set()(and all the other

such functions for objects and arrays) will return with an error status. The

indirect case is the dangerous one:

json_t *arr1 = json_array(), *arr2 = json_array();

json_array_append(arr1, arr2); json_array_append(arr2, arr1);

In this example, the arrayarr2is contained in the arrayarr1, and vice versa.

Jansson cannot check for this kind of indirect circular references without a

performance hit, so it’s up to the user to avoid them.

If a circular reference is created, the memory consumed by the values cannot

be freed byjson_decref(). The reference counts never drops to zero

because the values are keeping the references to each other. Moreover,

trying to encode the values with any of the encoding functions will fail. The

encoder detects circular references and returns an error status.

True, False and Null

实现的这三个值是单例，所以返回的指针调用这些函数之间也不会改变。

json_t*json_true(void)

Return value: New reference.

Returns the JSON true value.

json_t*json_false(void)

Return value: New reference.

Returns the JSON false value.

json_t*json_boolean(val)

Return value: New reference.

Returns JSON false ifvalis zero, and JSON true otherwise. This is a

macro, and equivalent toval.?.json_true().:.json_false().

New in version 2.4.

json_t*json_null(void)

Return value: New reference.

Returns the JSON null value.

String¶

Jansson uses UTF-8 as the character encoding. All JSON strings must be

valid UTF-8 (or ASCII, as it’s a subset of UTF-8). Normal null terminated C

strings are used, so JSON strings may not contain embedded null characters.

All other Unicode codepoints U+0001 through U+10FFFF are allowed.

json_t*json_string(const char*value)

Return value: New reference.

Returns a new JSON string, orNULLon error.valuemust be a valid

UTF-8 encoded Unicode string.

json_t*json_string_nocheck(const char*value)

Return value: New reference.

Likejson_string(), but doesn’t check thatvalueis valid UTF-8. Use this

function only if you are certain that this really is the case (e.g. you have

already checked it by other means).

const char *json_string_value(constjson_t*string)

Returns the associated value ofstringas a null terminated UTF-8

encoded string, orNULLifstringis not a JSON string.

The retuned value is read-only and must not be modified or freed by

the user. It is valid as long asstringexists, i.e. as long as its reference

count has not dropped to zero.

剩余26页未读，继续阅读

评论收藏

内容反馈

资源评论

资源反馈

评论星级较低，若资源使用遇到问题可联系上传者，3个工作日内问题未解决可申请退款~

tianwaifeishi17

2013-10-21

Jansson开发文档，不错
Zaki_huang

2018-04-15

还可以，能用的
longfeiq

2013-11-23

Jansson开发文档，没有预想的好

朔望两弦

粉丝: 12
资源: 9

上传资源快速赚钱

我的内容管理展开

我的资源快来上传第一个资源

我的收益

登录查看自己的收益

我的积分登录查看自己的积分

我的C币登录后查看C币余额

我的收藏

我的下载

下载帮助

前往需求广场，查看用户热搜

janssonAPI翻译

stm32中janssonAPI的中文版

Keil.Jansson.1.0.0_jansson_Keil.Jansson_keil5工具_keil5_

jansson：C库，用于编码，解码和处理JSON数据

Keil.Jansson.1.0.0.zip

Keil提供的JSON库的使用参数说明--API Reference — Jansson 2

cpp-Jansson进行编解码和操作JSON数据的C语言库

jansson, 用于编码，解码和操作JSON数据的C 库.zip

stm32_Cjson源码

jansson windows 下使用的x64和x86的lib库

keil.Jansson.1.0.0.pack

Keil.Jansson.1.0.0.pack资源下载！

KEIL JSON Keil.Jansson.1.0.0.pack

STM32循迹小车（灰度+OpenMV权重判断）

谭浩强C语言程序设计第五版详细答案

基于CAPL的S19文件解析

MQTT协议设备客户端与图传APP.zip

Keil.STM32H7xx-DFP.3.1.1.pack

基于stm32f407的示波器+FFT频谱分析

C语言求一个正整数的位数

zlib-1.2.13.tar.gz

猴子吃桃问题c语言.猴子吃桃问题c语言

STM32CubeIDE 1.14.0 自动补全代码

mingw64.zip

c语言贪吃蛇-项目实战

基于STM32的FFT频谱分析+波形识别

ORIGIN消除demo字样，适用ORIGIN2018版本

vc6.0企业版

51单片机16*16点阵，源代码+仿真实现

c51单片机流水灯c51单片机流水灯

最新资源