白菜跨语言数据类型打包与解包标准

不知道 · 发表于 5 天前

本帖最后由不知道于 2025-12-29 14:08 编辑

白菜跨语言数据类型封包与解包标准

简介

~AI的崛起，或许需要的是万物互联吧；

目前提供了易语言和PHP实现作为参考示例（它是一个设计标准，不局限于语言本身），旨在提供一套简单高效、跨语言的数据封包（FB）与解包（deFB）方案，便于在对数据进行统一的二进制参数级交互（封包中无需存档额外元信息）

支持基本数据类型（singned/unsigned char/short/int/int64,bool,float/double）
支持字符串,字节集（String,Bytes）
支持数组（包含以上基本类型，及其下面结构体数组）
支持结构体（对象序列化/反序列化，嵌套结构体/结构体数组）

设计标准参考

https://wiki.xbcsoft.com/BC-FB-Standard

代码仓库

https://github.com/xbcsoft/BC-FB-Standard

快速示例（PHP）

<?php
include 'FB.php';

// 准备数据
$a = 123;           //int
$b = 'hello';       //string

// 生成打包（FB 将把字段编码为二进制格式）
$fb = FB(i16($a), $b);
// 输出打包的可读形式（解字节集十进制视图）
echo "FB bytes: " . jzjj($fb) . "\n";

// 解包示例（将打包数据还原到所有变量，需提前给定反射类型—脚本语言这里可用特定初值表示）
$out_a = T_short;
$out_b = T_String;
deFB($fb, $out_a, $out_b);

echo "解包结果：a={$out_a}, b={$out_b}\n";

// 解包示例（对按索引读取）
$first = gFB($fb, 0);                        //取第一个参数（按字节集）
echo "参数1（原始）：" .jzjj($first). "\n";
$first_int = gFBi($fb, 0);                   //取第一个参数（按整数）
echo "参数1（整型）：" .$first_int. "\n";
$second = gFB($fb, 1);                       //取第二个参数
echo "参数2：" .$second. "\n";

解包结果：a=123, b=hello
参数1（原始）：Bytes:2{123,0}
参数1（整型）：123
参数2：hello

数组、结构体更多示例请参考：

https://wiki.xbcsoft.com/BC-FB-Standard/?file=3.0_打包数据类型的存储结构.html

https://wiki.xbcsoft.com/BC-FB-Standard/?file=4.0_结构体对象的打包方案.html

快速示例（易语言）

窗口程序集名	保留	保留	备注
窗口程序集_启动窗口

子程序名	返回值类型	公开	备注
__启动窗口_创建完毕

TEST_基本数据类型 ()
' TEST_基本类型含数组 ()

子程序名	返回值类型	公开	备注
TEST_基本数据类型

变量名	类型	静态	数组	备注
char	字节型
bool	逻辑型			尽管易语言内部是4字节，封包后统一约定1字节
short	短整数型
int	整数型
int64	长整数型
float	小数型
double	双精度小数型
string	文本型
bytes	字节集
fb	字节集

连续赋值 (1, char, short, int, float, double)
bool ＝真
int64 ＝ 274877906943
bytes ＝到字节集 (“world”)
fb ＝ FB (char, short, int, int64, float, double, “hello”, bytes, bool)  ' 可直接投入字面量（但注意字节集不能直接投）
调试输出 (fb)
调试输出 (gFBi (fb, 0), gFBi (fb, 1), gFBi (fb, 2), gFBl (fb, 3), gFBf (fb, 4), gFBf (fb, 5))
调试输出 (gFBs (fb, 6), gFB (fb, 7))
调试输出 (gFBb (fb, 8), gFB (fb, 8))  ' 逻辑型在FB中统一1字节
连续赋值 (0, char, short, int, float, double, int64)  ' 这里清空仅为了不受旧值干扰
bool ＝假
string ＝ “”
bytes ＝ {  }
deFB (fb, char, short, int, int64, float, double, string, bytes, bool)
调试输出 (“——————————————————————————————————”)
调试输出 (char, short, int, int64, float, double)
调试输出 (string, bytes)
调试输出 (bool)

子程序名	返回值类型	公开	备注
TEST_基本类型含数组

变量名	类型	静态	数组	备注
charArr	字节型		3
boolArr	逻辑型		3	尽管易语言内部是4字节，封包后统一约定1字节
shortArr	短整数型		3
intArr	整数型		3
int64Arr	长整数型		3
floatArr	小数型		3
doubleArr	双精度小数型		3
stringArr	文本型		3
bytesArr	字节集		3
fb	字节集

fb ＝ FB (charArr, boolArr)
调试输出 (fb)  ' (1+2+1)*4+{ [4+3(+1)] + [4+3(+1)] }
shortArr ＝ { 111, 2222 }  ' 可动态与之前声明的大小不同
fb ＝ FB (shortArr, { 123, 4567, 89101112, 666, 77 })  ' 可直接投入字面量(整型)数组
连续赋值 ({  }, shortArr, intArr)  ' 这里清空仅为了不受旧值干扰
deFB (fb, shortArr, intArr)
调试输出 (shortArr, intArr)
stringArr [1] ＝ “aaaaa”
stringArr [2] ＝ “bb”
stringArr [3] ＝ “cccc”
bytesArr [2] ＝到字节集 (“hello world”)
fb ＝ FB (stringArr, bytesArr)
清除数组 (stringArr)
deFB (fb, stringArr)
调试输出 (stringArr, bytesArr)

i支持库列表	支持库注释
bcFB	(未知支持库)
spec	特殊功能支持库

.版本 2<br />
.支持库 bcFB<br />
.支持库 spec<br />
<br />
.程序集 窗口程序集_启动窗口<br />
<br />
.子程序 __启动窗口_创建完毕<br />
<br />
TEST_基本数据类型 ()<br />
' TEST_基本类型含数组 ()<br />
<br />
.子程序 TEST_基本数据类型<br />
.局部变量 char, 字节型<br />
.局部变量 bool, 逻辑型, , , 尽管易语言内部是4字节，封包后统一约定1字节<br />
.局部变量 short, 短整数型<br />
.局部变量 int, 整数型<br />
.局部变量 int64, 长整数型<br />
.局部变量 float, 小数型<br />
.局部变量 double, 双精度小数型<br />
.局部变量 string, 文本型<br />
.局部变量 bytes, 字节集<br />
.局部变量 fb, 字节集<br />
<br />
连续赋值 (1, char, short, int, float, double)<br />
bool ＝ 真<br />
int64 ＝ 274877906943<br />
bytes ＝ 到字节集 (“world”)<br />
fb ＝ FB (char, short, int, int64, float, double, “hello”, bytes, bool)  ' 可直接投入字面量（但注意字节集不能直接投）<br />
调试输出 (fb)<br />
调试输出 (gFBi (fb, 0), gFBi (fb, 1), gFBi (fb, 2), gFBl (fb, 3), gFBf (fb, 4), gFBf (fb, 5))<br />
调试输出 (gFBs (fb, 6), gFB (fb, 7))<br />
调试输出 (gFBb (fb, 8), gFB (fb, 8))  ' 逻辑型在FB中统一1字节<br />
<br />
连续赋值 (0, char, short, int, float, double, int64)  ' 这里清空仅为了不受旧值干扰<br />
bool ＝ 假<br />
string ＝ “”<br />
bytes ＝ {  }<br />
deFB (fb, char, short, int, int64, float, double, string, bytes, bool)<br />
调试输出 (“——————————————————————————————————”)<br />
调试输出 (char, short, int, int64, float, double)<br />
调试输出 (string, bytes)<br />
调试输出 (bool)<br />
<br />
<br />
.子程序 TEST_基本类型含数组<br />
.局部变量 charArr, 字节型, , "3"<br />
.局部变量 boolArr, 逻辑型, , "3", 尽管易语言内部是4字节，封包后统一约定1字节<br />
.局部变量 shortArr, 短整数型, , "3"<br />
.局部变量 intArr, 整数型, , "3"<br />
.局部变量 int64Arr, 长整数型, , "3"<br />
.局部变量 floatArr, 小数型, , "3"<br />
.局部变量 doubleArr, 双精度小数型, , "3"<br />
.局部变量 stringArr, 文本型, , "3"<br />
.局部变量 bytesArr, 字节集, , "3"<br />
.局部变量 fb, 字节集<br />
<br />
fb ＝ FB (charArr, boolArr)<br />
调试输出 (fb)  ' (1+2+1)*4+{ [4+3(+1)] + [4+3(+1)] }<br />
<br />
shortArr ＝ { 111, 2222 }  ' 可动态与之前声明的大小不同<br />
fb ＝ FB (shortArr, { 123, 4567, 89101112, 666, 77 })  ' 可直接投入字面量(整型)数组<br />
连续赋值 ({  }, shortArr, intArr)  ' 这里清空仅为了不受旧值干扰<br />
deFB (fb, shortArr, intArr)<br />
调试输出 (shortArr, intArr)<br />
<br />
stringArr [1] ＝ “aaaaa”<br />
stringArr [2] ＝ “bb”<br />
stringArr [3] ＝ “cccc”<br />
bytesArr [2] ＝ 到字节集 (“hello world”)<br />
fb ＝ FB (stringArr, bytesArr)<br />
清除数组 (stringArr)<br />
deFB (fb, stringArr)<br />
调试输出 (stringArr, bytesArr)

复合结构体嵌套示例（易语言）

数据类型名	公开	备注
A
成员名	类型	传址	数组	备注
a	短整数型
b	文本型

数据类型名	公开	备注
B
成员名	类型	传址	数组	备注
aa	A
bb	字节集		1

数据类型名	公开	备注
C
成员名	类型	传址	数组	备注
aaa	A		2
bbb	B		1

窗口程序集名	保留	保留	备注
窗口程序集_启动窗口

子程序名	返回值类型	公开	备注
__启动窗口_创建完毕

子程序_TESTA ()
' 子程序_TESTB ()
' 子程序_TESTC ()

子程序名	返回值类型	公开	备注
子程序_TESTA

变量名	类型	静态	数组	备注
o	A
dat	字节集
o_	A

o.a ＝ 123
o.b ＝ “hello”
dat ＝ FB_A (o)
调试输出 (dat)
deFB_A (pFB (dat), o_)
调试输出 (o_.a, o_.b)

子程序名	返回值类型	公开	备注
子程序_TESTB

变量名	类型	静态	数组	备注
o	B
a	字节集		0
fb	字节集
o_bb	字节集		0
p_aa	子程序指针
p	整数型
o_	B

o.aa.a ＝ 123666 ' 注意易语言这里是有符号短整数
o.aa.b ＝ “你好”
o.bb [1] ＝到字节集 (“hello”)
fb ＝ FB_B (o)
deFB_B (pFB (fb), o_)
调试输出 (o_.aa.a, o_.aa.b, o_.bb)

子程序名	返回值类型	公开	备注
子程序_TESTC

变量名	类型	静态	数组	备注
o	C
fb	字节集
o_	C

重定义数组 (o.bbb, 假, 3) ' 这里可后期随意动态重定义，可以与原先易语言表格中的不一样
o.aaa [1].a ＝ 123
o.aaa [1].b ＝ “你是真的6”
o.bbb [1].aa.a ＝ 12306
o.bbb [1].aa.b ＝ “你好啊”
o.bbb [1].bb [1] ＝到字节集 (“hello”)
fb ＝ FB_C (o)
' 调试输出 (fb)
deFB_C (pFB (fb), o_)
调试输出 (o_.aaa [1].a, o_.aaa [1].b)
调试输出 (o_.bbb [1].aa.a, o_.bbb [1].aa.b)
调试输出 (o_.bbb) ' 数组:3{(?未知?),(?未知?),(?未知?)}
调试输出 (o_.bbb [1].bb)

i支持库列表	支持库注释
spec	特殊功能支持库
bcFB	(未知支持库)

.版本 2<br />
.支持库 spec<br />
.支持库 bcFB<br />
<br />
.数据类型 A<br />
    .成员 a, 短整数型<br />
    .成员 b, 文本型<br />
<br />
.数据类型 B<br />
    .成员 aa, A<br />
    .成员 bb, 字节集, , "1"<br />
<br />
.数据类型 C<br />
    .成员 aaa, A, , "2"<br />
    .成员 bbb, B, , "1"<br />
<br />
<br />
.程序集 窗口程序集_启动窗口<br />
<br />
.子程序 __启动窗口_创建完毕<br />
<br />
子程序_TESTA ()<br />
' 子程序_TESTB ()<br />
' 子程序_TESTC ()<br />
<br />
.子程序 子程序_TESTA<br />
.局部变量 o, A<br />
.局部变量 dat, 字节集<br />
.局部变量 o_, A<br />
<br />
o.a ＝ 123<br />
o.b ＝ “hello”<br />
dat ＝ FB_A (o)<br />
调试输出 (dat)<br />
deFB_A (pFB (dat), o_)<br />
调试输出 (o_.a, o_.b)<br />
<br />
<br />
.子程序 子程序_TESTB<br />
.局部变量 o, B<br />
.局部变量 a, 字节集, , "0"<br />
.局部变量 fb, 字节集<br />
.局部变量 o_bb, 字节集, , "0"<br />
.局部变量 p_aa, 子程序指针<br />
.局部变量 p, 整数型<br />
.局部变量 o_, B<br />
<br />
o.aa.a ＝ 123666  ' 注意易语言这里是有符号短整数<br />
o.aa.b ＝ “你好”<br />
o.bb [1] ＝ 到字节集 (“hello”)<br />
<br />
fb ＝ FB_B (o)<br />
deFB_B (pFB (fb), o_)<br />
调试输出 (o_.aa.a, o_.aa.b, o_.bb)<br />
<br />
<br />
.子程序 子程序_TESTC<br />
.局部变量 o, C<br />
.局部变量 fb, 字节集<br />
.局部变量 o_, C<br />
<br />
重定义数组 (o.bbb, 假, 3)  ' 这里可后期随意动态重定义，可以与原先易语言表格中的不一样<br />
o.aaa [1].a ＝ 123<br />
o.aaa [1].b ＝ “你是真的6”<br />
o.bbb [1].aa.a ＝ 12306<br />
o.bbb [1].aa.b ＝ “你好啊”<br />
o.bbb [1].bb [1] ＝ 到字节集 (“hello”)<br />
fb ＝ FB_C (o)<br />
' 调试输出 (fb)<br />
<br />
deFB_C (pFB (fb), o_)<br />
调试输出 (o_.aaa [1].a, o_.aaa [1].b)<br />
调试输出 (o_.bbb [1].aa.a, o_.bbb [1].aa.b)<br />
调试输出 (o_.bbb)  ' 数组:3{(?未知?),(?未知?),(?未知?)}<br />
调试输出 (o_.bbb [1].bb)

PS：源码中使用上了支持库，原因是只有支持库才能提供必需的基础类型反射，不过源码中已包含支持库源码可放心食用（有能力可以自行编译，此外易语言静态库没打包在里头，可加我群里免费获得）

最后欢迎加群讨论【白易语言研究院】：Q群668536886

不知道 · 发表于 4 天前

本帖最后由不知道于 2025-12-29 14:14 编辑

看来"feng包"一词被卦佬们玩坏了，之前标题打这两个字被论坛系统替换成了"请求"，我现改成了"打包"以免产生误会
下集预告，白菜通信过程调用模块源码
——涵盖：协程(及其扩展接口+已实现的部分协程生态)、IPC(进程间通信)、RPC(基于TCP/HTTP的远程过程调用)

please · 发表于昨天 09:39

感谢分享，支持开源！！！

please · 发表于前天 09:36

感谢分享，支持开源！！！

一指温柔 · 发表于 3 天前

感谢分享，很给力！~

please · 发表于 3 天前

感谢分享，支持开源！！！

futiem · 发表于 4 天前

白菜跨语言数据类型打包与解包标准

wh1234567 · 发表于 4 天前

支持开源

lm88818 · 发表于 4 天前

感谢分享，很给力！~

胖子葛格 · 发表于 4 天前

感谢大神分享~！

		自动登录	找回密码
密码			注册

[易语言纯源码] 白菜跨语言数据类型打包与解包标准

白菜跨语言数据类型封包与解包标准

简介

设计标准参考

代码仓库

快速示例（PHP）

数组、结构体更多示例请参考：