pack

New in version 1.30.20.

语法

pack(format, args…)

参数

format 格式字符串，用于指定数据格式。指定方式参见附录。关于格式字符串的说明：

格式字符之前可以带有整数表示重复计数。例如，格式字符串 ‘4h’ 的含义与 ‘hhhh’ 完全相同。

格式之间的空白字符会被忽略；但是计数及其格式字符中不可有空白字符。

对于 ‘s’ 格式字符，计数会被解析为字节的长度，而不是重复计数；例如，’10s’ 表示一个 10 字节的字节串，而 ‘10c’ 表示 10 个字符。若未给出计数，则默认值为1。字节串会被适当地截断或填充空字节以符合要求。

args… 表示需要进行打包的数据。参数个数与 format 的长度一致。每个参数的类型与对应位置的 format 类型一致。

详情

将数据按照 format 指定的格式打包成二进制字节流。返回一个 bytes 对象，包含 args 数据按照格式字符串 format 打包后的值。

例子

$ res = pack("N",1);
$ res1 = unpack("N", res);
$ print(res1)
(1)

$ res = pack("iii", 1, 2, 3)
$ res1 = unpack("iii",  res);
$ print(res1)
(1,2,3)

$ res = pack("x",NULL)
$ res = unpack("x",pack("x",NULL))
$ typestr(res[0])
VOID

$ res = pack("3si", `123, 3)
$ res1 = unpack("3si",  res);
$ print(res1)
("123",3)

附录

格式和类型的对应关系见 1.1 格式字符与类型。

默认情况下，C类型以本机格式和字节顺序表示，在必要时通过跳过填充字节进行正确对齐（根据 C 编译器使用的规则）。

格式字符串的第一个字符可用于指示打包数据的字节顺序，大小和对齐方式，见 1.2 首字符字节顺序，大小和对齐方式。如果第一个字符不是其中之一，则按 ‘@’ 处理。