(PHP 4, PHP 5, PHP 7, PHP 8)
pack — 將數(shù)據(jù)打包成二進(jìn)制字符串
將輸入?yún)?shù)打包成 format 格式的二進(jìn)制字符串。
這個(gè)函數(shù)的思想來自 Perl，所有格式化代碼（format）的工作原理都與
Perl 相同。 但是，缺少了部分格式代碼，比如 Perl 的 “u”。
注意，有符號(hào)值和無符號(hào)值之間的區(qū)別只影響函數(shù) unpack()，在那些使用有符號(hào)和無符號(hào)格式代碼的地方 pack() 函數(shù)產(chǎn)生相同的結(jié)果。
format
format
字符串由格式代碼組成，后面跟著一個(gè)可選的重復(fù)參數(shù)。重復(fù)參數(shù)可以是一個(gè)整數(shù)值或者
* 值來重復(fù)到輸入數(shù)據(jù)的末尾。對(duì)于 a, A, h, H
格式化代碼，其后的重復(fù)參數(shù)指定了給定數(shù)據(jù)將會(huì)被使用幾個(gè)字符串。對(duì)于
@，其后的數(shù)字表示放置剩余數(shù)據(jù)的絕對(duì)定位（之前的數(shù)據(jù)將會(huì)被空字符串填充），對(duì)于其他所有內(nèi)容，重復(fù)數(shù)量指定消耗多少個(gè)數(shù)據(jù)參數(shù)并將其打包到生成的二進(jìn)制字符串中。
目前已實(shí)現(xiàn)的格式如下：
| 代碼 | 描述 |
|---|---|
| a | 以 NUL 字節(jié)填充字符串 |
| A | 以 SPACE(空格) 填充字符串 |
| h | 十六進(jìn)制字符串，低位在前 |
| H | 十六進(jìn)制字符串，高位在前 |
| c | 有符號(hào)字符 |
| C | 無符號(hào)字符 |
| s | 有符號(hào)短整型(16位，主機(jī)字節(jié)序) |
| S | 無符號(hào)短整型(16位，主機(jī)字節(jié)序) |
| n | 無符號(hào)短整型(16位，大端字節(jié)序) |
| v | 無符號(hào)短整型(16位，小端字節(jié)序) |
| i | 有符號(hào)整型(機(jī)器相關(guān)大小字節(jié)序) |
| I | 無符號(hào)整型(機(jī)器相關(guān)大小字節(jié)序) |
| l | 有符號(hào)長整型(32位，主機(jī)字節(jié)序) |
| L | 無符號(hào)長整型(32位，主機(jī)字節(jié)序) |
| N | 無符號(hào)長整型(32位，大端字節(jié)序) |
| V | 無符號(hào)長整型(32位，小端字節(jié)序) |
| q | 有符號(hào)長長整型(64位，主機(jī)字節(jié)序) |
| Q | 無符號(hào)長長整型(64位，主機(jī)字節(jié)序) |
| J | 無符號(hào)長長整型(64位，大端字節(jié)序) |
| P | 無符號(hào)長長整型(64位，小端字節(jié)序) |
| f | 單精度浮點(diǎn)型(機(jī)器相關(guān)大小) |
| g | 單精度浮點(diǎn)型(機(jī)器相關(guān)大小，小端字節(jié)序) |
| G | 單精度浮點(diǎn)型(機(jī)器相關(guān)大小，大端字節(jié)序) |
| d | 雙精度浮點(diǎn)型(機(jī)器相關(guān)大小) |
| e | 雙精度浮點(diǎn)型(機(jī)器相關(guān)大小，小端字節(jié)序) |
| E | 雙精度浮點(diǎn)型(機(jī)器相關(guān)大小，大端字節(jié)序) |
| x | NUL 字節(jié) |
| X | 回退一字節(jié) |
| Z | 以 NUL 字節(jié)填充字符串空白 |
| @ | NUL 填充到絕對(duì)位置 |
values
返回包含數(shù)據(jù)的二進(jìn)制字符串， 或者在失敗時(shí)返回 false。
| 版本 | 說明 |
|---|---|
| 8.0.0 |
此函數(shù)不再在失敗時(shí)返回 false 。
|
| 7.2.0 | float 和 double 類型支持大端和小端。 |
| 7.0.15,7.1.1 | 添加了 “e”,“E”,“g” 和 “G” 代碼以啟用 float 和 double 的字節(jié)順序支持。 |
示例 #1 pack() 范例
<?php
$binarydata = pack("nvc*", 0x1234, 0x5678, 65, 66);
?>
輸出結(jié)果為長度為 6 字節(jié)的二進(jìn)制字符串，包含以下序列 0x12, 0x34, 0x78, 0x56, 0x41, 0x42。
Note that PHP internally stores int values as
signed values of a machine-dependent size (C type long).
Integer literals and operations that yield numbers outside the bounds of the
int type will be stored as float.
When packing these floats as integers, they are first cast into the integer
type. This may or may not result in the desired byte pattern.
The most relevant case is when packing unsigned numbers that would
be representable with the int type if it were unsigned.
In systems where the int type has a 32-bit size, the cast
usually results in the same byte pattern as if the int were
unsigned (although this relies on implementation-defined unsigned to signed
conversions, as per the C standard). In systems where the
int type has 64-bit size, the float most
likely does not have a mantissa large enough to hold the value without
loss of precision. If those systems also have a native 64-bit C
int type (most UNIX-like systems don't), the only way to
use the I pack format in the upper range is to create
int negative values with the same byte representation
as the desired unsigned value.