C语言序列化和反序列化--TPL中的API（三）

tpl_map

创建tpl的唯一方法是调用tpl_map()。第一个参数是格式字符串。后面是格式字符串中特定字符所需的参数列表。例如,

tpl_node *tn;
int i;
tn = tpl_map( "A(i)", &i );

该函数在格式字符串中的项和给定地址的C程序变量之间创建映射。稍后，C变量将在封装或解压缩tpl时被读取或写入。

这个函数成功时返回tpl_node*，失败时返回NULL。

tpl_pack

函数tpl_pack()将数据打包到一个tpl中。tpl_pack()的参数是一个tpl_node*和一个索引号。

tn = tpl_map("A(i)A(c)", &i, &c);
for(i=0; i<10; i++) tpl_pack(tn, 1);    /* pack 0-9 into index 1 */
for(c='a'; c<='z'; c++) tpl_pack(tn, 2); /* pack a-z into index 2 */
数据在打包时被复制

每次调用tpl_pack()都会立即复制正在打包的数据。因此，程序可以自由地立即覆盖或重用打包的变量。

索引号0

只有当格式字符串包含不在A(…)内的字符时，例如格式字符串iA©中的i，才有必要打包索引号0。
变长数组
向数组中添加元素

要向变长数组中添加元素，请反复调用tpl_pack()。每次调用都会向数组中添加另一个元素。
零长度数组是可以的

将任何内容都不打包到可变长度数组中是完全可以接受的，从而导致零长度数组。
填充嵌套数组

在包含嵌套可变长度数组的格式字符串中，例如a (a (s))，内部子数组应该在父数组之前打包。

当您打包父数组时，当前子数组的“快照”将被放入父元素的新元素中。打包父数组也会清空子数组。这样，您就可以将新数据打包到子数据中，然后再打包到父数据中。这将创建不同的父元素，每个父元素包含不同的子数组。
当处理像A(A(i))这样的嵌套数组时，从“内向外”(子优先)打包它们，但从“外向内”(父优先)解包它们。
下面的示例创建了一个格式字符串为a (a ©)的tpl。

#include "tpl.h"int main() {char c;tpl_node *tn;tn = tpl_map("A(A(c))", &c);for(c='a'; c<'c'; c++) tpl_pack(tn,2);  /* pack child (twice) */tpl_pack(tn, 1);                        /* pack parent */for(c='1'; c<'4'; c++) tpl_pack(tn,2);  /* pack child (three times) */tpl_pack(tn, 1);                        /* pack parent */tpl_dump(tn, TPL_FILE, "test40.tpl");tpl_free(tn);
}

这将创建一个嵌套数组，其中父元素有两个元素:第一个元素是双元素嵌套数组a, b;第二个元素是包含三个元素的嵌套数组1,2,3。嵌套解包示例展示了如何解包该tpl。

tpl_dump()

在打包tpl之后，使用tpl_dump()将tpl映像写入文件、内存缓冲区或文件描述符。相应的模式如下所示。最后一种模式用于查询输出大小，而不实际执行转储。
在这里插入图片描述第一个参数是tpl_node*，第二个参数是以下常量之一:

TPL_FILE

将tpl写入一个文件名由以下参数给出的文件。该文件的创建权限为664 (rw-rw-r——)，除非被进程umask进一步限制。
TPL_FD

将tpl写入以下参数中给出的文件描述符。描述符可以是阻塞的，也可以是非阻塞的，但如果是非阻塞的，并且不能立即写入内容，则会进行忙循环。
TPL_MEM

将tpl写入内存缓冲区。下面两个参数必须是void**和size_t*。该函数将分配一个缓冲区，并将其地址和长度存储到这些位置。调用者在使用完缓冲区后负责free()。
TPL_MEM | TPL_PREALLOCD

将tpl写入调用方已经分配或声明的内存缓冲区。下面两个参数必须是void*和size_t，分别指定缓冲区地址和大小。(如果缓冲区的大小不足以接收tpl转储，该函数将返回-1)。该模式可以与TPL_EXCESS_OK模式中的tpl_load结合使用，如下所示。
TPL_GETSIZE

这种特殊模式实际上并不转储tpl。相反，它将转储所需的大小放入以下参数所指向的size_t中。

成功时返回值为0，错误时返回值为-1。

tpl_dump()函数不会释放tpl。完成后使用tpl_free()释放tpl的资源。
背靠背的tpl图像不需要分隔符
如果您希望存储一系列tpl图像，或者通过套接字传输顺序的tpl图像(可能作为消息传递给另一个程序)，您可以简单地按顺序转储它们，而无需为单个tpl图像添加任何分隔符。Tpl图像是内部分隔的，因此tpl_load每次只读取一个图像，即使多个图像是连续的。

tpl_load

这个API函数从文件、内存缓冲区或文件描述符中读取先前转储的tpl映像，并为随后的解包做好准备。将交叉检查前面调用tpl_map()中指定的格式字符串是否与存储在tpl映像中的格式字符串相等。

tn = tpl_map( "A(i)", &i );
tpl_load( tn, TPL_FILE, "demo.tpl" );

tpl_load()的第一个参数是tpl_node*。第二个参数是常量之一:

TPL_FILE

从以下参数中指定的文件加载tpl。也可以使用TPL_EXCESS_OK按位或这个标志，如下所述。
TPL_MEM

从内存缓冲区加载tpl。下面两个参数必须是void*和size_t，分别指定缓冲区地址和大小。调用者必须在使用tpl_free()释放tpl之后才释放内存缓冲区。(如果调用者希望移交释放内存缓冲区的责任，以便在调用tpl_free()时自动释放内存缓冲区和tpl，则常数TPL_UFREE可以与TPL_MEM按位或来实现这一点)。此外，TPL_MEM可以与TPL_EXCESS_OK进行位或运算，如下所述。
TPL_FD

从以下参数中给出的文件描述符加载tpl。读取描述符，直到加载一个完整的tpl映像;不会读取超过TPL映像末尾的任何字节。描述符可以是阻塞的，也可以是非阻塞的，但如果非阻塞且不能立即读取内容，则将进行忙循环。

在加载过程中，将广泛检查tpl映像的内部有效性。

此函数成功时返回0，错误时返回-1。
TPL_EXCESS_OK

当从文件或内存(但不是从文件描述符)读取tpl映像时，文件或内存缓冲区的大小必须完全等于存储在其中的tpl映像的大小。换句话说，不允许有超出tpl图像的多余尾随数据。位标志TPL_EXCESS_OK可以与TPL_MEM或TPL_FILE进行或处理，以放松此要求。

这个标志在TPL_MEM| tpl_preallod模式下与tpl_dump一起使用时很有用。在本例中，只要LEN足够大，程序本身并不关心实际的tpl大小。

char buf[LEN];  /* will store and read tpl images here */
...
tpl_dump(tn, TPL_MEM|TPL_PREALLOCD, buf, LEN);
...
tpl_load(tn, TPL_MEM|TPL_EXCESS_OK, buf, LEN);

tpl_unpack()

tpl_unpack()函数的作用是:从tpl解包数据。当数据被解包时，它被复制到最初在tpl_map()中指定的C程序变量中。tpl_unpack的第一个参数是tpl的tpl_node*，第二个参数是索引号。

tn = tpl_map( "A(i)A(c)", &i, &c );
tpl_load( tn, TPL_FILE, "nested.tpl" );
while (tpl_unpack( tn, 1) > 0) printf("i is %d\n", i); /* unpack index 1 */
while (tpl_unpack( tn, 2) > 0) printf("c is %c\n", c); /* unpack index 2 */

索引号0

只有当格式字符串包含不在A(…)内的字符时，例如格式字符串iA©中的i，才有必要解包索引号0。
变长数组
从数组中拆包元素

对于变长数组，每次调用tpl_unpack()都会解包另一个元素。返回值可以用来告诉你什么时候完成了:如果它是正的，一个元素被解包;如果它是0，没有解包，因为没有更多的元素。负返回值表示错误(例如无效的索引号)。在本文档中，我们通常使用while循环来解包可变长度数组:

while( tpl_unpack( tn, 1 ) > 0 ) {/* got another element */
}

数组长度

在解包可变长度数组时，提前知道需要解包多少元素可能会很方便。您可以使用tpl_allen()来获取这个数字。
拆包嵌套数组

在包含嵌套可变长度数组(如a (a (s)))的格式字符串中，在解压缩子数组之前解压缩外部父数组。

当您解压缩父数组时，它会为解压缩准备子数组。在解包子数组的元素之后，程序可以通过解包另一个父元素来重复这个过程，然后解包子元素，依此类推。下面的示例解包一个格式字符串为a (a ©)的tpl。

拆包嵌套数组
#include "tpl.h"
#include <stdio.h>int main() {char c;tpl_node *tn;tn = tpl_map("A(A(c))", &c);tpl_load(tn, TPL_FILE, "test40.tpl");while (tpl_unpack(tn,1) > 0) {while (tpl_unpack(tn,2) > 0) printf("%c ",c);printf("\n");}tpl_free(tn);
}

文件test40。TPL来自嵌套打包示例。当运行时，这个程序输出:

a b
1 2 3

tpl_free

任何tpl的最后一步是使用tpl_free()释放它。它唯一的参数是要释放的tpl_node*。

tpl_free( tn );

这个函数不返回值(它是void)。

tpl_Alen

该函数接受一个tpl_node*和一个索引号，并返回一个int值，该值指定变长数组中的元素个数。

num_elements = tpl_Alen(tn, index);

这对于解包数据并需要提前知道需要解包的元素数量的程序非常有用。(它返回当前元素的数目;它将随着元素被解包而减小)。

tpl_peek

这个函数窥视包含tpl图像的文件或内存缓冲区，并返回其格式字符串的副本。它还可以查看格式字符串中任何固定长度数组的长度，或者也可以查看存储在tpl中的数据。
格式偷看

格式字符串可以像这样获得:

fmt = tpl_peek(TPL_FILE, "file.tpl");
fmt = tpl_peek(TPL_MEM, addr, sz);

如果成功，则返回格式字符串的副本。调用者最终必须释放它。如果出现错误，例如不存在的文件或无效的tpl映像，则返回NULL。
数组长度峰值

格式字符串中所有定长数组的长度都可以通过TPL_FXLENS模式查询。它提供了这种固定长度数组的数量及其长度。如果前者不为零，则调用方必须在完成后释放后者数组。格式字符串本身也必须被释放。

uint32_t num_fxlens, *fxlens, j;
fmt = tpl_peek(TPL_FILE|TPL_FXLENS, filename, &num_fxlens, &fxlens);
if (fmt) {printf("format %s, num_fxlens %u\n", fmt, num_fxlens);for(j=0; j<num_fxlens; j++) printf("fxlens[%u] %u\n", j, fxlens[j]);if (num_fxlens > 0) free(fxlens);free(fmt);
}

TPL_FXLENS模式与TPL_DATAPEEK模式互斥。
数据窥视

为了窥探数据，使用了额外的参数。这是映射、加载和解包tpl的一种快速替代方法，但是窥视仅限于索引0中的数据。换句话说，不要窥探A(…)类型。假设文件中的tpl映像。tpl的格式字符串为siA(i)。那么索引0的格式字符就是si。下面是窥视其内容的方法:

char *s;
int i;
fmt = tpl_peek(TPL_FILE | TPL_DATAPEEK, "file.tpl", "si", &s, &i);

现在已经用数据填充了s、i和fmt。调用者最终必须释放fmt和s，因为它们是分配的字符串。当然，它可以与TPL_MEM和TPL_FILE一起工作。请注意，TPL_DATAPEEK是与该模式相关联的。你也可以指定索引0格式的任何前导部分，如果你不想偷看整个东西:

fmt = tpl_peek(TPL_FILE | TPL_DATAPEEK, "file.tpl", "s", &s);

TPL_DATAPEEK模式与TPL_FXLENS模式互斥。
结构查看

最后，您可以查看索引0中的S(…)结构，但在格式中省略周围的S(…)，并指定一个参数来单独接收每个结构成员。可以指定结构格式的任何前导部分。例如if struct。tpl具有格式字符串S(si)，您可以通过以下方式查看其数据:

fmt = tpl_peek(TPL_FILE | TPL_DATAPEEK, "struct.tpl", "s", &s);
fmt = tpl_peek(TPL_FILE | TPL_DATAPEEK, "struct.tpl", "si", &s, &i);

tpl_jot

这是生成tpl的快捷方式。它可以用来代替通常的“映射、打包、转储和释放”的生命周期。使用tpl_jot，所有这些步骤都可以为您处理。它只适用于简单的格式——即那些格式字符串中没有A(…)的格式。下面是它的用法:

char *hello = "hello", *world = "world";
tpl_jot( TPL_FILE, "file.tpl", "ss", &hello, &world);

支持TPL_FILE、TPL_FD和TPL_MEM三种标准模式。失败时返回-1(例如格式字符串错误或写入文件错误)，成功时返回0。

tpl_hook

大多数用户会让这些钩子保持默认值。如果希望修改tpl的内部内存管理和错误报告行为，可以更改这些钩子值。

一个名为tpl_hook的全局结构封装了钩子。程序可以通过指定一个原型与默认值匹配的替代函数来重新配置任何钩子。例如:

#include "tpl.h"
extern tpl_hook_t tpl_hook;int main() {tpl_hook.oops = printf;...
}

tpl_gather

这个函数的原型是:

int tpl_gather( int mode, ...);

mode参数是下面列出的三个常量之一，它必须后跟特定于模式的必需参数:

TPL_GATHER_BLOCKING,    int fd, void **img, size_t *sz
TPL_GATHER_NONBLOCKING, int fd, tpl_gather_t **gs, tpl_gather_cb *cb, void *data
TPL_GATHER_MEM,         void *addr, size_t sz, tpl_gather_t **gs, tpl_gather_cb *cb, void *data

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.mzph.cn/diannao/20101.shtml

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

自定义对象池BasePooledObjectFactory的使用

自定义对象池BasePooledObjectFactory的使用

项目中用到了apache的对象池来管理文件导出相关资源连接和回收功能&#xff0c;因此花点时间简单了解下对象池相关使用&#xff0c;做点记录。 一. 连接池 频繁的建立和关闭连接&#xff0c;会极大的降低系统的性能&#xff0c;而连接池会在初始化的时候会创建一定数量的连接…
阅读更多...
C++ | Leetcode C++题解之第123题买卖股票的最佳时机III

C++ | Leetcode C++题解之第123题买卖股票的最佳时机III

题目&#xff1a; 题解&#xff1a; class Solution { public:int maxProfit(vector<int>& prices) {int n prices.size();int buy1 -prices[0], sell1 0;int buy2 -prices[0], sell2 0;for (int i 1; i < n; i) {buy1 max(buy1, -prices[i]);sell1 max(…
阅读更多...
FPGA高端项目：FPGA解码MIPI视频+图像缩放+视频拼接，基于MIPI CSI-2 RX Subsystem架构实现，提供4套工程源码和技术支持

FPGA高端项目：FPGA解码MIPI视频+图像缩放+视频拼接，基于MIPI CSI-2 RX Subsystem架构实现，提供4套工程源码和技术支持

目录 1、前言工程概述免责声明 2、相关方案推荐我这里已有的 MIPI 编解码方案本方案在Xilinx Artix7-35T上解码MIPI视频的应用本方案在Xilinx Artix7-100T上解码MIPI视频的应用本方案在Xilinx Kintex7上解码MIPI视频的应用本方案在Xilinx Zynq7000上解码MIPI视频的应用本方案在…
阅读更多...
11.1 排序算法

11.1 排序算法

目录 11.1 排序算法 11.1.1 评价维度 11.1.2 理想排序算法 11.1 排序算法 排序算法&#xff08;sorting algorithm&#xff09;用于对一组数据按照特定顺序进行排列。排序算法有着广泛的应用&#xff0c;因为有序数据通常能够被更高效地查找、分析和处理。 如图 1…
阅读更多...
常用电机测试方法的介绍与功能实现（M测试方法）

常用电机测试方法的介绍与功能实现（M测试方法）

目录 概述 1 常用电机测速方法简介 1.1 方法概览 1.2 编码器测速方法 2 M法测速 2.1 理论描述 2.2 实现原理 2.3 速度计算方法 3 功能实现 3.1 功能介绍 3.2 代码实现 3.2.1 使用STM32Cube配置参数 3.2.2 脉冲计数功能 3.2.3 测速函数 4 测试 概述 本文主要介绍…
阅读更多...
黑马一站制造数仓实战2

黑马一站制造数仓实战2

问题 DG连接问题 原理&#xff1a;JDBC&#xff1a;用Java代码连接数据库 Hive/SparkSQL&#xff1a;端口有区别 可以为同一个端口&#xff0c;只要不在同一台机器 项目&#xff1a;一台机器 HiveServer&#xff1a;10000 hiveserver.port 10000 SparkSQL&#xff1a;10001…
阅读更多...
一维时间序列信号的广义傅里叶族变换（Matlab）

一维时间序列信号的广义傅里叶族变换（Matlab）

广义傅里叶族变换是一种时频变换方法&#xff0c;傅里叶变换、短时傅里叶变换、S变换和许多小波变换都是其特殊情况&#xff0c;完整代码及子函数如下&#xff0c;很容易读懂&#xff1a; % Run a demo by creating a signal, transforming it, and plotting the results% Cre…
阅读更多...
不同厂商SOC芯片在视频记录仪领域的应用

不同厂商SOC芯片在视频记录仪领域的应用

不同SoC公司芯片在不同产品上的应用信息&#xff1a; 大唐半导体 芯片型号: LC1860C (主控) LC1160 (PMU)产品应用: 红米2A (399元)大疆晓Spark技术规格: 28nm工艺&#xff0c;4个ARM Cortex-A7处理器&#xff0c;1.5GHz主频&#xff0c;2核MaliT628 GPU&#xff0c;1300万像…
阅读更多...
计算属性与监听属性

计算属性与监听属性

【 1 】计算属性 计算属性大致就是这样 # 1 计算属性是基于它们的依赖进行缓存的# 2 计算属性只有在它的相关依赖发生改变时才会重新求值# 3 计算属性就像Python中的property&#xff0c;可以把方法/函数伪装成属性 # 计算属性本质上是一个函数&#xff0c;它们可以通过 get…
阅读更多...
数据隐私新篇章：Facebook如何保护用户信息

数据隐私新篇章：Facebook如何保护用户信息

随着数字化时代的到来&#xff0c;数据隐私保护成为了社交媒体平台和用户共同关注的焦点。作为全球最大的社交网络之一&#xff0c;Facebook一直致力于保护用户的隐私和数据安全。本文将深入探讨Facebook在数据隐私保护方面的措施和实践&#xff0c;以及其如何开启数据隐私的新…
阅读更多...
vue实现简易基本对话功能

vue实现简易基本对话功能

基于vue3.0实现的功能&#xff0c;仿照微信、QQ聊天界面。 HTML代码块 <template><el-container style"height: 100%" ref"bodyform"><div class"el_main_content"><div class"main_content_header">这是一…
阅读更多...
Git基本配置，使用Gitee（一）

Git基本配置，使用Gitee（一）

1、设置Giter的user name和email 设置提交用户的信息 git config --global user.name "username" git config --global user.email "Your e-mail"查看配置 git config --list2、生成 SSH 公钥 通过命令 ssh-keygen 生成 SSH Key -t key 类型 -C 注释 ssh-…
阅读更多...
K8S 证书过期不能使用kubectl之后，kubeadm 重新生成证书

K8S 证书过期不能使用kubectl之后，kubeadm 重新生成证书

查询证书过期时间 kubeadm certs check-expiration重新生成证书 # 重新生成所有证书 kubeadm certs renew all # 重新生成某个组件的证书 kubeadm certs renew 组件名称 如&#xff1a;apiserver生成新的配置 # 重新生成kubeconfig配置 kubeadm init phase kubeconfig # 重…
阅读更多...
LabVIEW中PID控制器系统的噪声与扰动抑制策略

LabVIEW中PID控制器系统的噪声与扰动抑制策略

在LabVIEW中处理PID控制器系统中的噪声和外部扰动&#xff0c;需要从信号处理、控制算法优化、硬件滤波和系统设计四个角度入手。采用滤波技术、调节PID参数、增加前馈控制和实施硬件滤波器等方法&#xff0c;可以有效减少噪声和扰动对系统性能的影响&#xff0c;提高控制系统的…
阅读更多...
原生小程序一键获取手机号

原生小程序一键获取手机号

1.效果图 2.代码index.wxml <!-- 获取手机号 利用手机号快速填写的功能&#xff0c;将button组件 open-type 的值设置为 getPhoneNumber--><button open-type"getPhoneNumber" bindgetphonenumber"getPhoneNumber">获取手机号</button> …
阅读更多...
Spring使用的设计模式

Spring使用的设计模式

Spring 框架是一个广泛使用的 Java 框架&#xff0c;它内部使用了多种设计模式来简化开发过程、提高代码的可维护性和扩展性。 以下是一些在 Spring 框架中常见的设计模式&#xff0c;以及用代码示例来解释它们&#xff1a; 一、工厂模式&#xff08;Factory Pattern&#xff…
阅读更多...
elasticsearch7.15实现用户输入自动补全

elasticsearch7.15实现用户输入自动补全

Elasticsearch Completion Suggester&#xff08;补全建议&#xff09; Elasticsearch7.15安装 官方文档 补全建议器提供了根据输入自动补全/搜索的功能。这是一个导航功能&#xff0c;引导用户在输入时找到相关结果&#xff0c;提高搜索精度。 理想情况下&#xff0c;自动补…
阅读更多...
02-CSS3基本样式

02-CSS3基本样式

目录 1. CSS3简介 1.1 CSS3的兼容情况 1.2 优雅降级和渐进增强的开发思想 2. 新增选择器 2.1 选择相邻兄弟 2.2 匹配选择器 2.3 属性选择器(重点) 2.4 结构性伪类选择器&#xff08;重点&#xff09; 2.4.1 整体结构类型 2.4.2 标签结构类型 2.4.3 指定子元素的序号&…
阅读更多...
模型训练、结果存储、API 调用的系列优化｜ModelWhale 版本更新

模型训练、结果存储、API 调用的系列优化｜ModelWhale 版本更新

蜂飞蝶舞&#xff0c;万物并秀&#xff0c;明媚的春光中 ModelWhale 带来新一轮的版本更新&#xff0c;期待为大家带来更优质的使用体验。 本次更新中&#xff0c;ModelWhale 主要进行了以下功能迭代&#xff1a; 新增 IDE 中使用训练记录&#xff08;专业版✓ 团队版✓&…
阅读更多...
Ansible04-Ansible Vars变量详解

Ansible04-Ansible Vars变量详解

目录 写在前面6 Ansible Vars 变量6.1 playbook中的变量6.1.1 playbook中定义变量的格式6.1.2 举例6.1.3 小tip 6.2 共有变量6.2.1 变量文件6.2.1.1 变量文件编写6.2.1.2 playbook编写6.2.1.3 运行测试 6.2.2 根据主机组使用变量6.2.2.1 groups_vars编写6.2.2.2 playbook编写6.…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023