binary - 從(向)二進制串插入和提取字段??? SYNOPSISbinary format formatString ?arg arg ...?binary scan string formatString ?varName varName ...? _________________________________________________________________??? DESCRIPTION這個命令提供操縱二進制數據的設施。第一種形式是 binary format，從普通的Tcl 值來建立一個二進制串。例如，給出值 16 和22，可以產生一個8字節的二進制串，由兩個4字節的整數組成。第二種形式是binary scan，做相反的事: 從一個二進制串中提取出數據并作為通常的 Tcl字符串值而返回。????? BINARY FORMATbinary format 命令生成一個二進制串，其格式由 formatString指定，它的內容來(自在后面)增添的參數。返回結果二進制值。formatString由零個或多個字段說明符(specifier)的序列組成，用零個或多個空格分隔。每個說明符都是一個單獨的類型字符，跟隨著一個可選的數值count。多數字段說明符消耗(consume)一個參數來獲取被格式化的值。類型字符指定如何格式化值。count典型的指示從值中接受了多少個指定類型的單項(item)。如果count存在，則是一個非負十進制整數或*，星號通常指示使用在值中所有的單項。如果參數的個數不匹配在消耗參數的這些格式串中的字段的個數，則產生一個錯誤。每個類型-數目(type-count)對在二進制串上移動一個假想的游標，在當前的位置上存儲一些字節并且游標前進到最近存儲的字節的緊后面。游標初始在位置0 也就是在數據的開始(端)。類型可以是下列字符中的任意一個:a 在輸出串中存儲長度是 count 的一個字符串。如果 arg 比 count的字節數少，則有增補的零字節來填充字段。如果 arg比指定長度多，忽略額外的字符。如果 count 是 *, 則格式化在 arg中的所有字節。如果省略了 count ，則格式化一個字符。例如，binary format a7a*a alpha bravo charlie將返回等價于 alpha\000\000bravoc的一個串。A 除了使用空格而不是空字符來填充之外，這種形式同于 a。例如，binary format A6A*A alpha bravo charlie將返回 alpha bravoc.b 在輸出串中存儲 count個二進制數字的一個串，并且在每個字節中以從低到高的次序(來排序)。Arg必須包含一個 1 和 0字符的一個序列。以從最先到最后的次序散布(emit)結果字節，并且以在每個字節中以從低到高的次序格式化每位。如果arg 比 count 的位數少，則剩余的位使用零。如果 arg比指定的位數多，忽略額外的位。如果 count 是 *, 則格式化在 arg中所有的位。如果省略了count，則格式化一位。如果如果格式化的位數不結束在字節邊界上，最后的字節的剩余的位將是零。例如，binary format b5b* 11100 111000011010將返回等價于 \x07\x87\x05的一個串。B 除了在每個字節中以從高到低的次序(來排序)之外，這種形式同于b。例如，binary format B5B* 11100 111000011010將返回等價于 \xe0\xe1\xa0的一個串。h 在輸出串中存儲 count個十六進制的數字的一個串，并且在每個字節中以從低到高的次序(來排序)。Arg必須包含在“0123456789abcdefABCDEF”(字符)集中的字符的一個序列。以從最先到最后的次序散布(emit)結果字節，并且在每個字節中以從低到高的次序格式化十六進制數字。如果arg 比 count 的數字個數少，則剩余的數字使用零。如果 arg比指定的數字的個數多，忽略額外的數字。如果 count 是 *，則格式化在arg 中所有的數字。如果省略了 count，則格式化一個數字。如果格式化的數字的個數不結束在一個字節的邊界上，最后的字節的剩余的位將是零。例如，binary format h3h* AB def將返回等價于 \xba\x00\xed\x0f的一個串。H 除了在每個字節中以從高到低的次序(來排序)之外，這種形式同于 h。例如，binary format H3H* ab DEF將返回等價于 \xab\x00\xde\xf0的一個串。c 在輸出串中存儲一個或多個8位整數值。如果未指定 count，則 arg必須包含一個整數值；否則 arg必須包含至少有一個整數元素的一個列表。在當前的位置上把每個整數的低位(low-order)的 8 位存儲成一個一字節的值。如果 count 是*，則格式化在列表中所有的整數。如果在列表中的元素的個數比 count少，則產生一個錯誤。 如果在列表中的元素的個數比 count多，則忽略額外的元素。例如，binary format c3cc* {3 -3 128 1} 260 {2 5}將返回等價于 \x03\xfd\x80\x04\x02\x05 的一個串。而binary format c {2 5}將產生一個錯誤。s 除了以小端(little-endian)字節序在輸出串中存儲一個或多個16位整數之外，這種形式同于c。在當前位置上把每個整數的低位的16位存儲成一個兩字節的值，并且首先存儲最低有效(significant)字節。例如，binary format s3 {3 -3 258 1}將返回等價于 \x03\x00\xfd\xff\x02\x01 的一個字串。S 除了以大端(big-endian)字節序在輸出串中存儲一個或多個16位整數之外，這種形式同于 s。例如，binary format S3 {3 -3 258 1}將返回等價于 \x00\x03\xff\xfd\x01\x02 的一個串。i 除了以小端(little-endian)字節序在輸出串中存儲一個或多個32位整數之外，這種形式同于c。在當前位置上把每個整數的低位的32位存儲成一個四字節的值，并且首先存儲最低有效字節。例如，binary format i3 {3 -3 65536 1}將返回等價于 \x03\x00\x00\x00\xfd\xff\xff\xff\x00\x00\x01\x00的一個串。I 除了以大端(big-endian)字節序在輸出串中存儲一個或多個32位整數之外，這種形式同于i。例如，binary format I3 {3 -3 65536 1}將返回等價于 \x00\x00\x00\x03\xff\xff\xff\xfd\x00\x01\x00\x00的一個串。f 除了以機器的本地表示在輸出串中存儲一個或多個單精度浮點數之外，這種形式同于c。這種表示是不能跨體系移植的，所以不應用于在網絡上交流浮點數。浮點數的大小在體系間可能不同，所以生成的字節數也可能不同。如果值溢出了機器的本地表示，則使用系統定義的FLT_MAX 的值。因為 Tcl在內部使用雙精度浮點數，在轉換成單精度時可能損失些精度。例如，運行在Intel Pentium 處理器的一個 Windows 系統上，binary format f2 {1.6 3.4}將返回等價于 \xcd\xcc\xcc\x3f\x9a\x99\x59\x40 的一個串。d 除了以機器的本地表示在輸出串中存儲一個或多個雙精度浮點數之外，這種形式同于f。例如，運行在 Intel Pentium 處理器的一個 Windows 系統上，binary format d1 {1.6}將返回等價于 \x9a\x99\x99\x99\x99\x99\xf9\x3f 的一個串。x Stores count null bytes in the output string. If count is notspecified, stores one null byte. If count is *, generates anerror. This type does not consume an argument. For example,binary format a3xa3x2a3 abc def ghi將返回等價于 abc\000def\000\000ghi 的一個串。X 在輸出串中反向移動游標 count 字節。如果 count 是 *或比當前游標位置大，則游標定位到位置0，這樣下個存儲的字節將是結果串中的第一個字節。如果省略了count，則游標反向移動一字節。這種形式不使用參數。例如，binary format a3X*a3X2a3 abc def ghi將返回 dghi.@ 在輸出串中把游標移動到由 count 指定的絕對位置上。位置 0參照在輸出串中的第一個字節。如果 count參照的位置超出至今所存儲的最后的字節，則在空擋的(unitialized?)位置上放置空字節并把游標放置到指定位置。如果 count 是*，則游標將被移動到輸出串的末端。如果省略了count，則產生一個錯誤。這種類型不使用參數。例如，binary format a5@2a1@*a3@10a1 abcde f ghi j將返回 abfdeghi\000\000j.??????? BINARY SCANbinary scan 命令從一個二進制串分析字段、返回完成的轉換的數目。String給出要被分析的輸入而 formatString 指示如何分析它。每個 varName給出一個變量的名字；當從 string檢索出一個字段時，結果被賦給相應的變量。如同 binary format 那樣，formatString由零個或多個字段說明符(specifier)的序列組成，用零個或多個空格分隔。每個說明符都是一個單獨的類型字符，跟隨著一個可選的數值count。多數字段說明符消耗(consume)一個參數來獲取檢索出的值要放置在其中的那個變量。類型字符指定如何解釋二進制串。count典型的指定從數據中接受指定類型的多少個單項(item)。如果存在，count是一個非負數的十進制整數或*，星號通常指示要用到在數據中所有的剩余的單項。如果在滿足當前字段說明符的當前位置之后沒有剩下足夠的字節，則相應的變量保持不動(untouch)而binary scan立即返回設置了的變量的個數。如果沒有足夠的參數給所有這些消耗參數的格式串中的字段，則產生一個錯誤。著重 (important) 注意 c, s 和 S(還有在64位系統上的 i 和II)將被檢索成一個長整型 (long)大小的值。在這種情況下，(最)高位設置(為1)的值(對于char 是 0x80，對于short 是 0x8000，對于 int 是0x80000000)，將被符號擴展。所以下列情況將發生:set signShort [binary format s1 0x8000]binary scan $signShort s1 val; # val == 0xFFFF8000如果你打算生成一個無符號值，那么你可以把返回值屏蔽(mask)成需要的大小。例如，要生成一個無符號short 值:set val [expr {$val & 0xFFFF}]; # val == 0x8000每個類型-數目(type-count)對在二進制串上移動一個假想的游標，從當前的位置上讀一些字節。游標的初始在位置0 也就是數據的開始(端)。類型可以是下列字符中的任意一個:a 數據是長度是 count 的一個字符串。如果 count 是 *，則在 string中所有的剩余的字節將被檢索到變量中。如果省略了count，則將檢索一個字符。例如，binary scan abcde\000fghi a6a10 var1 var2將返回 1 并把等價于 abcde\000 的一個字符串存儲到 var1 而 var2保持不變。A 除了在存儲到變量之前從檢索到的值中去除(strip)尾隨的空白(blank)和空字符(null)之外，這種形式同于a。例如binary scan "abc efghi \000" A* var1將返回 1 并把 abc efghi 存儲到 var1。b 把數據轉換成 count位二進制數字的一個字符串，以從低到高的次序表示成“1”和“0”字符的一個序列。數據字節按從最先到最后的次序被檢索，并且在每個字節中按從低到高的次序接受(每)位。忽略在最后的字節中的任何額外的位。如果count 是 *，則檢索在串中的所有的剩余的位。 如果省略了count，則檢索一位。例如，binary scan \x07\x87\x05 b5b* var1 var2將返回 2 并把 11100 存儲到 var1 且 1110000110100000 存儲到 var2.B 除了在每字節中按從高到低的次序接受(每)位之外，這種形式同于b。例如，binary scan \x70\x87\x05 B5B* var1 var2將返回 2 并把 01110 存儲到 var1 且 1000011100000101 存儲到 var2.h 把數據轉換成 count個十六進制數字的一個字符串，以從低到高的次序表示成一個在“0123456789abcdefABCDEF”(字符)集中的字符的一個序列。按從最先到最后的次序檢索數據字節，并且在每個字節中以從低到高的次序接受十六進制數字。忽略最后的字節中的任何額外的位。如果count 是 *, 則檢索在串中所有剩余的十六進制數字。如果省略了count，則檢索一位十六進制數字。例如，binary scan \x07\x86\x05 h3h* var1 var2將返回 2 并把 706 存儲到 var1 且 50 存儲到n var2.H 除了在每個字節中以從高到低的次序接受數字之外，這種形式同于h。例如，binary scan \x07\x86\x05 H3H* var1 var2將返回 2 并把 078 存儲到var1 且 05 存儲到 var2.c 把數據轉換成 count個8位有符號整數并作為一個列表存儲到相應的變量中。如果 count 是*，則檢索在串中所有剩余的字節。如果省略了count，則檢索一個8位整數。例如，binary scan \x07\x86\x05 c2c* var1 var2將返回2 并把 7 -122 存儲到 var1 且 5 存儲到 var2.注意返回的整數是有符號的，但它們是類似下面這樣的表達式來轉換成無符號的8位數量(quantity):expr ( $num + 0x100 ) % 0x100s 把數據解釋成 count 個表示為小端字節序的16位有符號整數。整數被作為一個列表存儲到相應的變量中。如果 count 是*，則檢索在串中所有剩余的字節。如果省略了count，則檢索一個16位整數。例如，binary scan \x05\x00\x07\x00\xf0\xff s2s* var1 var2將返回 2 并把 5 7 存儲到 var1 且 -16 存儲到 var2.注意返回的整數是有符號的，但它們是類似下面這樣的表達式來轉換成無符號的16位數量(quantity):expr ( $num + 0x10000 ) % 0x10000S 除了把數據解釋成 count個表示為大端字節序的16位有符號整數之外，這種形式同于 s。例如，binary scan \x00\x05\x00\x07\xff\xf0 S2S* var1 var2將返回 2 并把 5 7 存儲到 var1 且 -16 存儲到 var2.i 把數據解釋成 count 個表示為小端字節序的32位有符號整數。整數被作為一個列表存儲到相應的變量中。如果 count 是*，則檢索在串中所有剩余的字節。如果省略了count，則檢索一個32位整數。例如，binary scan \x05\x00\x00\x00\x07\x00\x00\x00\xf0\xff\xff\xff i2i* var1 var2將返回 2 ，并把 5 7 存儲到 var1 且 -16 存儲到var2。注意返回的整數是有符號的并且不能被 Tcl 表示成無符號的值。I 除了把數據解釋成 count個表示為大端字節序的32位有符號整數之外，這種形式同于 i。例如，binary \x00\x00\x00\x05\x00\x00\x00\x07\xff\xff\xff\xf0 I2I* var1 var2將返回 2 ，并把 5 7 存儲到 var1 且 -16 存儲到 var2。f 把數據解釋成 count個機器本地表示的單精度浮點數，把浮點數作為一個列表存儲到相應的變量中。如果 count 是 *，則檢索在串中所有剩余的字節。如果省略了count，則檢索一個單精度浮點數。浮點數的大小在體系間可能不同，所以檢索的字節數也可能不同。如果數據不表示一個有效的浮點數，結果值是未定義的并且依賴于編譯器。例如，運行在Intel Pentium 處理器的一個 Windows 系統上，binary scan \x3f\xcc\xcc\xcd f var1將返回 1，并把 1.6000000238418579 存儲到 var1。d 除了把數據解釋成 count個機器本地表示的雙精度浮點數之外，這種形式同 于 f。例如，運行在Intel Pentium 處理器的一個 Windows 系統上，binary scan \x9a\x99\x99\x99\x99\x99\xf9\x3f d var1將返回 1 ，并把 1.6000000000000001 存儲到 var11。x 在 string 中正向移動游標 count 字節。如果 count 是 *或比當前游標位置之后的字節數大，則游標定位到位置 string中的最后一個字節之后。如果省略了count，則游標正向移動一字節。 注意這種形式不消耗參數。例如，binary scan \x01\x02\x03\x04 x2H* var1將返回 1，并把 0304 存儲到 var1。X 在 string 中反向移動游標 count 字節。如果 count 是 *或比當前游標位置大，則游標定位到位置 0，這樣下個檢索的字節將是string 中的第一個字節。如果省略了count，則游標反向移動一字節。注意這種形式不消耗參數。例如，binary scan \x01\x02\x03\x04 c2XH* var1 var2將返回 2，并把 1 2 存儲到 var1 且 020304 存儲到 var2。@ 在數據串中把游標移動到由 countt 指定的絕對位置上。位置 0 參照在string 中的第一個字節。如果 count 參照的位置超出 string的末端，則把游標定位在最后的字節的后面。如果省略了count，則產生一個錯誤。例如， 　binary scan \x01\x02\x03\x04 c2@1H* var1 var2將返回 2 ，并把 1 2 存儲到 var1 且 020304 存儲到 var2。??????????? PLATFORM ISSUES有時希望以機器的本地字節序來格式化或檢索整數值。參照 tcl_platform數組中的 byteOrder 元素來決定在格式化或檢索整數時使用那種類型字符。

總結

以上是生活随笔為你收集整理的binary - 从(向)二进制串插入和提取字段 / BINARY FORMAT BINARY SCAN的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。