php binary frame,gbinary (二进制编解码)-CSDN博客

gf框架提供了独立的二进制数据操作包gbinary，主要用于各种数据类型与[ ]byte二进制类型之间的相互转换；以及针对于整型数据进行精准按位处理的功能。常用于网络通信时数据编码/解码，以及数据文件操作时的编码/解码。

使用方式：import "github.com/gogf/gf/encoding/gbinary"

接口文档：

用于二进制数据结构转换处理的接口文档如下：func Encode(vs ...interface{}) ([]byte, error)

func EncodeInt(i int) []byte

func EncodeInt8(i int8) []byte

func EncodeInt16(i int16) []byte

func EncodeInt32(i int32) []byte

func EncodeInt64(i int64) []byte

func EncodeUint(i uint) []byte

func EncodeUint8(i uint8) []byte

func EncodeUint16(i uint16) []byte

func EncodeUint32(i uint32) []byte

func EncodeUint64(i uint64) []byte

func EncodeBool(b bool) []byte

func EncodeFloat32(f float32) []byte

func EncodeFloat64(f float64) []byte

func EncodeString(s string) []byte

func Decode(b []byte, vs ...interface{}) error

func DecodeToInt(b []byte) int

func DecodeToInt8(b []byte) int8

func DecodeToInt16(b []byte) int16

func DecodeToInt32(b []byte) int32

func DecodeToInt64(b []byte) int64

func DecodeToUint(b []byte) uint

func DecodeToUint8(b []byte) uint8

func DecodeToUint16(b []byte) uint16

func DecodeToUint32(b []byte) uint32

func DecodeToUint64(b []byte) uint64

func DecodeToBool(b []byte) bool

func DecodeToFloat32(b []byte) float32

func DecodeToFloat64(b []byte) float64

func DecodeToString(b []byte) string

支持按位处理的接口文档如下：func EncodeBits(bits []Bit, i int, l int) []Bit

func EncodeBitsWithUint(bits []Bit, ui uint, l int) []Bit

func EncodeBitsToBytes(bits []Bit) []byte

func DecodeBits(bits []Bit) uint

func DecodeBitsToUint(bits []Bit) uint

func DecodeBytesToBits(bs []byte) []Bit

其中的Bit类型表示一个二进制数字(0或1)，其定义如下：type Bit int8

二进制操作示例

我们来看一个比较完整的二进制操作示例，基本演示了绝大部分的二进制转换操作。package main

import (

"fmt"

"github.com/gogf/gf/os/glog"

"github.com/gogf/gf/encoding/gbinary"

)

func main() {

// 使用gbinary.Encoded对基本数据类型进行二进制打包

if buffer := gbinary.Encode(18, 300, 1.01); buffer != nil {

// glog.Error(err)

} else {

fmt.Println(buffer)

}

// 使用gbinary.Decode对整形二进制解包，注意第二个及其后参数为字长确定的整形变量的指针地址，字长确定的类型，

// 例如：int8/16/32/64、uint8/16/32/64、float32/64

// 这里的1.01默认为float64类型(64位系统下)

if buffer := gbinary.Encode(18, 300, 1.01); buffer != nil {

//glog.Error(err)

} else {

var i1 int8

var i2 int16

var f3 float64

if err := gbinary.Decode(buffer, &i1, &i2, &f3); err != nil {

glog.Error(err)

} else {

fmt.Println(i1, i2, f3)

}

// 编码/解析 int，自动识别变量长度

fmt.Println(gbinary.DecodeToInt(gbinary.EncodeInt(1)))

fmt.Println(gbinary.DecodeToInt(gbinary.EncodeInt(300)))

fmt.Println(gbinary.DecodeToInt(gbinary.EncodeInt(70000)))

fmt.Println(gbinary.DecodeToInt(gbinary.EncodeInt(2000000000)))

fmt.Println(gbinary.DecodeToInt(gbinary.EncodeInt(500000000000)))

// 编码/解析 uint，自动识别变量长度

fmt.Println(gbinary.DecodeToUint(gbinary.EncodeUint(1)))

fmt.Println(gbinary.DecodeToUint(gbinary.EncodeUint(300)))

fmt.Println(gbinary.DecodeToUint(gbinary.EncodeUint(70000)))

fmt.Println(gbinary.DecodeToUint(gbinary.EncodeUint(2000000000)))

fmt.Println(gbinary.DecodeToUint(gbinary.EncodeUint(500000000000)))

// 编码/解析 int8/16/32/64

fmt.Println(gbinary.DecodeToInt8(gbinary.EncodeInt8(int8(100))))

fmt.Println(gbinary.DecodeToInt16(gbinary.EncodeInt16(int16(100))))

fmt.Println(gbinary.DecodeToInt32(gbinary.EncodeInt32(int32(100))))

fmt.Println(gbinary.DecodeToInt64(gbinary.EncodeInt64(int64(100))))

// 编码/解析 uint8/16/32/64

fmt.Println(gbinary.DecodeToUint8(gbinary.EncodeUint8(uint8(100))))

fmt.Println(gbinary.DecodeToUint16(gbinary.EncodeUint16(uint16(100))))

fmt.Println(gbinary.DecodeToUint32(gbinary.EncodeUint32(uint32(100))))

fmt.Println(gbinary.DecodeToUint64(gbinary.EncodeUint64(uint64(100))))

// 编码/解析 string

fmt.Println(gbinary.DecodeToString(gbinary.EncodeString("I'm string!")))

}

以上程序执行结果为：[18 44 1 41 92 143 194 245 40 240 63]

18 300 1.01

300

70000

2000000000

500000000000

300

70000

2000000000

500000000000

100

I'm string!编码

gbinary.Encode方法是一个非常强大灵活的方法，可以将所有的基本类型转换为二进制类型([ ]byte)。在gbinary.Encode方法内部，会自动对变量进行长度计算，采用最小二进制长度来存放该变量的二进制值。例如，针对int类型值为1的变量，gbinary.Encode将只会用1个byte来存储，而int类型值为300的变量，将会使用2个byte来存储，尽量减少二进制结果的存储空间。因此，在解析的时候要非常注意[ ]byte的长度，建议能够确定变量长度的地方，在进行二进制编码/解码时，尽量采用形如int8/16/32/64的定长基本类型来存储变量，这样解析的时候也能够采用对应的变量形式进行解析，不易产生错误。

gbinary包也提供了一系列gbinary.Encode*的方法，用于将基本数据类型转换为二进制。其中，gbinary.EncodeInt/gbinary.EncodeUint也是会在内部自动识别变量值大小，返回不定长度的[ ]byte值，长度范围1/2/4/8。

解码

在二进制类型的解析操作中，二进制的长度([ ]byte的长度)是非常重要的，只有给定正确的长度才能执行正确的解析，因此gbinary.Decode方法给定的变量长度必须为确定长度类型的变量，例如：int8/16/32/64、uint8/16/32/64、float32/64，而如果给定的第二个变量地址对应的变量类型为int/uint，无法确定长度，因此解析会失败。

此外，gbinary包也提供了一系列gbinary.DecodeTo*的方法，用于将二进制转换为特定的数据类型。其中，gbinary.DecodeToInt/gbinary.DecodeToUint方法会对二进制长度进行自动识别解析，支持的二进制参数长度范围1-8。

按位操作处理示例

gbinary的Bits相关操作简化了底层二进制位操作的复杂度，为精准的数据按位处理提供了可能。批量传感器状态数据上报示例

例如，针对于物联网项目而言，传感器设备是比较常见的硬件设备，我们以下的示例展示了网关向平台上报其下管理的传感器的状态信息。由于传感器状态只有4种(0:已下线，1:开启， 2:关闭， 3:待机)，正好对应了2个二进制位(2 bit)，因此1byte(8 bit)便可以表示出4个传感器设备的状态。

看以下的例子，用以上报平台100个传感器已开启，上报的状态顺序便是传感器在网关下端口顺序(索引从0开始)：package main

import (

"fmt"

"github.com/gogf/gf/encoding/gbinary"

)

func main() {

// 传感器状态，0:已下线, 1:开启, 2:关闭， 3:待机

count := 100

status := 1

// 网关编码

bits := make([]gbinary.Bit, 0)

for i := 0; i < count; i++ {

bits = gbinary.EncodeBits(bits, int(status), 2)

}

buffer := gbinary.EncodeBitsToBytes(bits)

fmt.Println("buffer length:", len(buffer))

/* 上报过程忽略，这里只展示编码/解码示例 */

// 平台解码

alivecount := 0

sensorbits := gbinary.DecodeBytesToBits(buffer)

for i := 0; i < len(sensorbits); i += 2 {

if gbinary.DecodeBits(sensorbits[i:i+2]) == 1 {

alivecount++

}

fmt.Println("alived sensor:", alivecount)

}

执行后输出结果为：buffer length: 25

alived sensor: 100

可以看到，上报100个传感器的状态数据只需要25byte即可，该示例中我们在平台上解码后统计开启的传感器数量有100台。

gkvdb数据库META数据结构操作示例

我们再看看一个实战的例子。gkvdb是gf框架相同作者开发的基于DRH算法的高性能Key-Value嵌入式数据库，其中元数据的存储数据结构如下：[键名哈希64(64bit,8byte) 键名长度(8bit,1byte) 键值长度(24bit,3byte) 数据文件偏移量(40bit,5byte)](变长)

我们使用一条元数据来演示编码/解码操作。package main

import (

"fmt"

"github.com/gogf/gf/encoding/gbinary"

)

func main() {

// Meta元数据文件数据结构：[键名哈希64(64bit,8byte) 键名长度(8bit,1byte) 键值长度(24bit,3byte) 数据文件偏移量(40bit,5byte)](变长)

hash := 521369841259754125

klen := 12

vlen := 35535

offset := 80000000

// 编码