awtk/docs/manual/ubjson_writer_t.md

ubjson_writer_t

概述

ubjson writer

函数

函数名称	说明
ubjson_writer_init	初始化。
ubjson_writer_write_array_begin	写入数组开始。

即： [ | | ubjson_writer_write_array_end | 写入数组结束。 即： ] | | ubjson_writer_write_char | 写入char。 | | ubjson_writer_write_data | 写入二进制数据。 | | ubjson_writer_write_false | 写入false。 | | ubjson_writer_write_float32 | 写入float。 | | ubjson_writer_write_float64 | 写入double。 | | ubjson_writer_write_int | 写入int。 | | ubjson_writer_write_int16 | 写入int16。 | | ubjson_writer_write_int32 | 写入int32。 | | ubjson_writer_write_int64 | 写入int64。 | | ubjson_writer_write_int8 | 写入int8。 | | ubjson_writer_write_key | 写入key。 | | ubjson_writer_write_kv_bool | 写入key和bool的值。

即："key": value | | ubjson_writer_write_kv_double | 写入key和double的值。

即："key": value | | ubjson_writer_write_kv_float | 写入key和float的值。

即："key": value | | ubjson_writer_write_kv_int | 写入key和int的值。

即："key": value | | ubjson_writer_write_kv_int64 | 写入key和int64_t的值。

即："key": value | | ubjson_writer_write_kv_object | 写key和对象。

即："key": { object } | | ubjson_writer_write_kv_object_begin | 写key和对象的开始。

即："key": { | | ubjson_writer_write_kv_str | 写入key和str的值。

即："key": value | | ubjson_writer_write_kv_str_len | 写入key和str的值。

即："key": value | | ubjson_writer_write_kv_value | 写入key和value_t的值。

即："key": value | | ubjson_writer_write_noop | 写入noop。 | | ubjson_writer_write_null | 写入null。 | | ubjson_writer_write_object | 写入obj。 | | ubjson_writer_write_object_begin | 写入对象开始。 即： { | | ubjson_writer_write_object_end | 写入对象结束。 即：} | | ubjson_writer_write_str | 写入str。 | | ubjson_writer_write_str_len | 写入str。 | | ubjson_writer_write_true | 写入true。 | | ubjson_writer_write_uint8 | 写入uint8。 |

ubjson_writer_init 函数

---

• 函数功能：

初始化。

• 函数原型：

ubjson_writer_t* ubjson_writer_init (ubjson_writer_t* writer, ubjson_write_callback_t write, void* ctx);

• 参数说明：

参数	类型	说明
返回值	ubjson_writer_t*	返回writer对象。
writer	ubjson_writer_t*	writer对象。
write	ubjson_write_callback_t	真正写入数据的函数。
ctx	void*	write函数的上下文。

ubjson_writer_write_array_begin 函数

---

• 函数功能：

写入数组开始。 即： [

• 函数原型：

ret_t ubjson_writer_write_array_begin (ubjson_writer_t* writer);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。

ubjson_writer_write_array_end 函数

---

• 函数功能：

写入数组结束。 即： ]

• 函数原型：

ret_t ubjson_writer_write_array_end (ubjson_writer_t* writer);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。

ubjson_writer_write_char 函数

---

• 函数功能：

写入char。

• 函数原型：

ret_t ubjson_writer_write_char (ubjson_writer_t* writer, char value);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。
value	char	要写入的值。

ubjson_writer_write_data 函数

---

• 函数功能：

写入二进制数据。

• 函数原型：

ret_t ubjson_writer_write_data (ubjson_writer_t* writer, const void* data, uint32_t size);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。
data	const void*	数据。
size	uint32_t	数据长度。

ubjson_writer_write_false 函数

---

• 函数功能：

写入false。

• 函数原型：

ret_t ubjson_writer_write_false (ubjson_writer_t* writer);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。

ubjson_writer_write_float32 函数

---

• 函数功能：

写入float。

• 函数原型：

ret_t ubjson_writer_write_float32 (ubjson_writer_t* writer, float value);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。
value	float	要写入的值。

ubjson_writer_write_float64 函数

---

• 函数功能：

写入double。

• 函数原型：

ret_t ubjson_writer_write_float64 (ubjson_writer_t* writer, double value);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。
value	double	要写入的值。

ubjson_writer_write_int 函数

---

• 函数功能：

写入int。

• 函数原型：

ret_t ubjson_writer_write_int (ubjson_writer_t* writer, int32_t value);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。
value	int32_t	要写入的值。

ubjson_writer_write_int16 函数

---

• 函数功能：

写入int16。

• 函数原型：

ret_t ubjson_writer_write_int16 (ubjson_writer_t* writer, int16_t value);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。
value	int16_t	要写入的值。

ubjson_writer_write_int32 函数

---

• 函数功能：

写入int32。

• 函数原型：

ret_t ubjson_writer_write_int32 (ubjson_writer_t* writer, int32_t value);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。
value	int32_t	要写入的值。

ubjson_writer_write_int64 函数

---

• 函数功能：

写入int64。

• 函数原型：

ret_t ubjson_writer_write_int64 (ubjson_writer_t* writer, int64_t value);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。
value	int64_t	要写入的值。

ubjson_writer_write_int8 函数

---

• 函数功能：

写入int8。

• 函数原型：

ret_t ubjson_writer_write_int8 (ubjson_writer_t* writer, int8_t value);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。
value	int8_t	要写入的值。

ubjson_writer_write_key 函数

---

• 函数功能：

写入key。

• 函数原型：

ret_t ubjson_writer_write_key (ubjson_writer_t* writer, const char* value);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。
value	const char*	key的名称。

ubjson_writer_write_kv_bool 函数

---

• 函数功能：

写入key和bool的值。

即："key": value

• 函数原型：

ret_t ubjson_writer_write_kv_bool (ubjson_writer_t* writer, const char* key, bool_t value);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。
key	const char*	键名。
value	bool_t	值。

ubjson_writer_write_kv_double 函数

---

• 函数功能：

写入key和double的值。

即："key": value

• 函数原型：

ret_t ubjson_writer_write_kv_double (ubjson_writer_t* writer, const char* key, double value);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。
key	const char*	键名。
value	double	值。

ubjson_writer_write_kv_float 函数

---

• 函数功能：

写入key和float的值。

即："key": value

• 函数原型：

ret_t ubjson_writer_write_kv_float (ubjson_writer_t* writer, const char* key, float value);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。
key	const char*	键名。
value	float	值。

ubjson_writer_write_kv_int 函数

---

• 函数功能：

写入key和int的值。

即："key": value

• 函数原型：

ret_t ubjson_writer_write_kv_int (ubjson_writer_t* writer, const char* key, int32_t value);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。
key	const char*	键名。
value	int32_t	值。

ubjson_writer_write_kv_int64 函数

---

• 函数功能：

写入key和int64_t的值。

即："key": value

• 函数原型：

ret_t ubjson_writer_write_kv_int64 (ubjson_writer_t* writer, const char* key, int64_t value);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。
key	const char*	键名。
value	int64_t	值。

ubjson_writer_write_kv_object 函数

---

• 函数功能：

写key和对象。

即："key": { object }

• 函数原型：

ret_t ubjson_writer_write_kv_object (ubjson_writer_t* writer, const char* key, object_t* value);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。
key	const char*	键名。
value	object_t*	对象。

ubjson_writer_write_kv_object_begin 函数

---

• 函数功能：

写key和对象的开始。

即："key": {

• 函数原型：

ret_t ubjson_writer_write_kv_object_begin (ubjson_writer_t* writer, const char* key);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。
key	const char*	键值。

ubjson_writer_write_kv_str 函数

---

• 函数功能：

写入key和str的值。

即："key": value

• 函数原型：

ret_t ubjson_writer_write_kv_str (ubjson_writer_t* writer, const char* key, const char* value);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。
key	const char*	键名。
value	const char*	字符串。

ubjson_writer_write_kv_str_len 函数

---

• 函数功能：

写入key和str的值。

即："key": value

• 函数原型：

ret_t ubjson_writer_write_kv_str_len (ubjson_writer_t* writer, const char* key, const char* value, uint32_t len);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。
key	const char*	键名。
value	const char*	字符串。
len	uint32_t	字符串的长度。

ubjson_writer_write_kv_value 函数

---

• 函数功能：

写入key和value_t的值。

即："key": value

• 函数原型：

ret_t ubjson_writer_write_kv_value (ubjson_writer_t* writer, const char* key, value_t* value);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。
key	const char*	键名。
value	value_t*	值。

ubjson_writer_write_noop 函数

---

• 函数功能：

写入noop。

• 函数原型：

ret_t ubjson_writer_write_noop (ubjson_writer_t* writer);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。

ubjson_writer_write_null 函数

---

• 函数功能：

写入null。

• 函数原型：

ret_t ubjson_writer_write_null (ubjson_writer_t* writer);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。

ubjson_writer_write_object 函数

---

• 函数功能：

写入obj。

• 函数原型：

ret_t ubjson_writer_write_object (ubjson_writer_t* writer, object_t* obj);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。
obj	object_t*	要写入的对象。

ubjson_writer_write_object_begin 函数

---

• 函数功能：

写入对象开始。 即： {

• 函数原型：

ret_t ubjson_writer_write_object_begin (ubjson_writer_t* writer);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。

ubjson_writer_write_object_end 函数

---

• 函数功能：

写入对象结束。 即：}

• 函数原型：

ret_t ubjson_writer_write_object_end (ubjson_writer_t* writer);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。

ubjson_writer_write_str 函数

---

• 函数功能：

写入str。

• 函数原型：

ret_t ubjson_writer_write_str (ubjson_writer_t* writer, const char* value);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。
value	const char*	要写入的字符串。

ubjson_writer_write_str_len 函数

---

• 函数功能：

写入str。

• 函数原型：

ret_t ubjson_writer_write_str_len (ubjson_writer_t* writer, const char* value, uint32_t len);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。
value	const char*	要写入的字符串。
len	uint32_t	字符串的长度。

ubjson_writer_write_true 函数

---

• 函数功能：

写入true。

• 函数原型：

ret_t ubjson_writer_write_true (ubjson_writer_t* writer);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。

ubjson_writer_write_uint8 函数

---

• 函数功能：

写入uint8。

• 函数原型：

ret_t ubjson_writer_write_uint8 (ubjson_writer_t* writer, uint8_t value);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
writer	ubjson_writer_t*	writer对象。
value	uint8_t	要写入的值。