Tcl字符串命令之binary

binary

binary format formatString ?arg arg ...?
binary scan str formatString ?varName varName ...?
binary encode format ?-option value ...? data
binary decode format ?-option value ...? data

binary用于操作二进制字符串。包含四个子命令：binary format可以将普通的Tcl字符串转换为二进制字符串。binary scan将二进制字符串转换为普通的Tcl字符串。binary encode将二进制字符串进行编码。binary decode将编码后的二进制字符串解码。二进制字符串的其他操作是由其他Tcl命令完成的。 二进制字符串字符的范围是\u0000-\u00FF，所以如果不想丢失数据，需要先通过encoding convertto进行转换。

format

binary format formatString ?arg arg ...?

binary format按格式字符串formatString生成并返回二进制字符串。formatString是格式字符串。如果arg参数的数量与格式字符串中的字段数量不匹配，则会产生一个错误。格式字符串中的标志字符会被忽略。

scan

binary scan str formatString ?varName varName ...?

binary scan将二进制字符串转换为普通的Tcl字符串，返回转换执行的次数。str为要解析的输入字符串，每个字符一个字节，超过1字节的字符的高位会被截断。formatString是格式字符串，表示如何解析字符串。varName为变量名，用于保存str解析的结果。如果没有足够的字节用于解析，则保持相应的变量不变，并返回已设置的变量的数量。如果没有足够的输入用于解析，则会产生错误。

encode/decode

binary encode format ?-option value ...? data
binary decode format ?-option value ...? data

encode和decode是Tcl8.6新增的子命令。在进行编码/解码时，需要同时指定使用的编码名称，并且可以指定可选的编码特定的选项。

格式	命令	选项	说明
base64	encode	-maxlen length	指定输出被分隔为长度不超过length的行，默认不分割。
		-wrapchar char	当输出被-maxlen选项分割时，使用指定的char字符做为行分隔符。默认为换行符“\n”。
	decode	-strict	如果指定此选项，则在解码器遇到空白字符时会抛出错误。否则忽略空白字符。
hex	decode	-strict	如果指定此选项，则在解码器遇到空白字符时会抛出错误。否则忽略空白字符。
uuencode	encode	-maxlen length	指定输出被分隔为长度不超过length的行，默认每行61个字符。由于编码限制，length必须在3-85之间。
		-wrapchar char	当输出被-maxlen选项分割时，使用指定的char字符做为行分隔符。默认为换行符“\n”。
	decode	-strict	如果指定此选项，则在解码器遇到空白字符时会抛出错误。否则忽略空白字符。

简单示例

set binStr [binary format f2 {1.2 3.4}]
binary scan $binStr f2 var
puts $var
set oriStr abcdef
set base64Str [binary encode base64 $oriStr]
binary decode base64 $base64Str