1勺远、golang包中的binary包是什么？
2时鸵、binary為我們開(kāi)發(fā)者提供了哪些內(nèi)容胶逢？以及怎么使用？
3饰潜、編解碼有哪幾種方法初坠？
轉(zhuǎn)化成二進(jìn)制格式與原本數(shù)據(jù)轉(zhuǎn)字符串相比會(huì)更節(jié)省空間
一、golang包中的binary包是什么彭雾？
此包實(shí)現(xiàn)了對(duì)數(shù)據(jù)與byte之間的轉(zhuǎn)換碟刺，以及varint的編解碼。
二薯酝、binary為我們開(kāi)發(fā)者提供了哪些內(nèi)容半沽？以及怎么使用？
數(shù)據(jù)的byte序列化轉(zhuǎn)換
func Read(r io.Reader, order ByteOrder, data interface{}) error
func Write(w io.Writer, order ByteOrder, data interface{}) error
func Size(v interface{}) int
uvarint和varint的編解碼
func PutUvalint(buf []byte, x uint64) int
func PutVarint(buf []byte, x int64) int
func Uvarint(buf []byte) (uint64, int)
func Varint(buf []byte) (int64, int)
func ReadUvarint(r io.ByteReader) (uint64, error)
func ReadVarint(r io.ByteReader) (int64, error)
結(jié)構(gòu)體
type ByteOrder：可以定義自己的字節(jié)序結(jié)構(gòu)吴菠，用于序列化和反序列化數(shù)據(jù)者填。
1）func Read(r io.Reader, order ByteOrder, data interface{}) error
參數(shù)列表：
1）r 可以讀出字節(jié)流的數(shù)據(jù)源
2）order 特殊字節(jié)序，包中提供大端字節(jié)序和小端字節(jié)序
3）data 需要解碼成的數(shù)據(jù)
返回值：error 返回錯(cuò)誤
功能說(shuō)明：Read從r中讀出字節(jié)數(shù)據(jù)并反序列化成結(jié)構(gòu)數(shù)據(jù)做葵。data必須是固定長(zhǎng)的數(shù)據(jù)值或固定長(zhǎng)數(shù)據(jù)的slice占哟。從r中讀出的數(shù)據(jù)可以使用特殊的 字節(jié)序來(lái)解碼，并順序?qū)懭雟alue的字段酿矢。當(dāng)填充結(jié)構(gòu)體時(shí)重挑，使用(_)名的字段講被跳過(guò)。
代碼案例
package main
import (
"fmt"
"log"
"bytes"
"encoding/binary"
)
func main() {
var pi float64
b := []byte{0x18,0x2d,0x44,0x54,0xfb,0x21,0x09,0x40}
buf := bytes.NewBuffer(b)
err := binary.Read(buf, binary.LittleEndian, &pi)
if err != nil {
log.Fatalln("binary.Read failed:", err)
}
fmt.Println(pi)
}
2）Write(w io.Writer, order ByteOrder, data interface{}) error
參數(shù)列表：
1）w 可寫(xiě)入字節(jié)流的數(shù)據(jù)
2）order 特殊字節(jié)序棠涮，包中提供大端字節(jié)序和小端字節(jié)序
3）data 需要解碼的數(shù)據(jù)
返回值：error 返回錯(cuò)誤
功能說(shuō)明：
Write講data序列化成字節(jié)流寫(xiě)入w中谬哀。data必須是固定長(zhǎng)度的數(shù)據(jù)值或固定長(zhǎng)數(shù)據(jù)的slice，或指向此類(lèi)數(shù)據(jù)的指針严肪。寫(xiě)入w的字節(jié)流可用特殊的字節(jié)序來(lái)編碼史煎。另外谦屑，結(jié)構(gòu)體中的(_)名的字段講忽略。
代碼案例：
package main
import (
"bytes"
"math"
"encoding/binary"
"log"
"fmt"
)
func main() {
buf := new(bytes.Buffer)
pi := math.Pi
err := binary.Write(buf, binary.LittleEndian, pi)
if err != nil {
log.Fatalln(err)
}
fmt.Println(buf.Bytes())
}
3）func Size(v interface{}) int
參數(shù)列表：v 需要計(jì)算長(zhǎng)度的數(shù)據(jù)
返回值：int 數(shù)據(jù)序列化之后的字節(jié)長(zhǎng)度
功能說(shuō)明：
Size講返回?cái)?shù)據(jù)系列化之后的字節(jié)長(zhǎng)度篇梭，數(shù)據(jù)必須是固定長(zhǎng)數(shù)據(jù)類(lèi)型氢橙、slice和結(jié)構(gòu)體及其指針。
代碼實(shí)例
package main
import (
"fmt"
"encoding/binary"
)
func main() {
var a int
p := &a
b := [10]int64{1}
s := "adsa"
bs := make([]byte, 10)
fmt.Println(binary.Size(a)) // -1
fmt.Println(binary.Size(p)) // -1
fmt.Println(binary.Size(b)) // 80
fmt.Println(binary.Size(s)) // -1
fmt.Println(binary.Size(bs)) // 10
}
4）func PutUvarint(buf []byte, x uint64) int
參數(shù)列表：
1）buf 需寫(xiě)入的緩沖區(qū)
2）x uint64類(lèi)型數(shù)字
返回值：
1）int 寫(xiě)入字節(jié)數(shù)恬偷。
2）panic buf過(guò)小悍手。
功能說(shuō)明：
PutUvarint主要是講uint64類(lèi)型放入buf中，并返回寫(xiě)入的字節(jié)數(shù)袍患。如果buf過(guò)小坦康，PutUvarint將拋出panic。
代碼案例
package main
import (
"encoding/binary"
"fmt"
"strconv"
)
func main() {
u16 := 1234
u64 := 0x1020304040302010
sbuf := make([]byte, 4)
buf := make([]byte, 10)
ret := binary.PutUvarint(sbuf, uint64(u16))
fmt.Println(ret, len(strconv.Itoa(u16)), sbuf)
ret = binary.PutUvarint(buf, uint64(u64))
fmt.Println(ret, len(strconv.Itoa(u64)), buf)
}
/*
輸出結(jié)果：
2 4 [210 9 0 0]
9 19 [144 192 192 129 132 136 140 144 16 0]
會(huì)發(fā)現(xiàn)轉(zhuǎn)成二進(jìn)制來(lái)傳輸數(shù)據(jù)诡延，比直接轉(zhuǎn)字符串之后轉(zhuǎn)[]byte這種方式傳更節(jié)省傳輸空間
*/
5）func PutVarint(buf []byte, x int64) int
參數(shù)列表：
1）buf 需要寫(xiě)入的緩沖區(qū)
2）x int64類(lèi)型數(shù)字
返回值：
1）int 寫(xiě)入字節(jié)數(shù)
2）panic buf過(guò)小
功能說(shuō)明：
PutVarint主要是講int64類(lèi)型放入buf中滞欠，并返回寫(xiě)入的字節(jié)數(shù)。如果buf過(guò)小肆良，PutVarint將拋出panic筛璧。
代碼案例：
package main
import (
"encoding/binary"
"fmt"
"strconv"
)
func main() {
i16 := 1234
i64 := -1234567890
sbuf := make([]byte, 4)
buf := make([]byte, 10)
ret := binary.PutVarint(buf, int64(i16))
fmt.Println(ret, len(strconv.Itoa(i16)), sbuf)
ret = binary.PutVarint(buf, int64(i64))
fmt.Println(ret, len(strconv.Itoa(i64)), buf)
}
/*
2 4 [0 0 0 0]
5 11 [163 139 176 153 9 0 0 0 0 0]
*/
6）func Uvarint(buf []byte) (uint64, int)
參數(shù)列表：buf 需要解碼的緩沖區(qū)
返回值：
1）uint64 解碼的數(shù)據(jù)。
2）int 解析的字節(jié)數(shù)惹恃。
功能說(shuō)明:
Uvarint是從buf中解碼并返回一個(gè)uint64的數(shù)據(jù),及解碼的字節(jié)數(shù)(>0)夭谤。如果出錯(cuò),則返回?cái)?shù)據(jù)0和一個(gè)小于等于0的字節(jié)數(shù)n,其意義為:
1)n == 0: buf太小
2)n < 0: 數(shù)據(jù)太大,超出uint64最大范圍,且-n為已解析字節(jié)數(shù)
代碼案例
package main
import (
"encoding/binary"
"fmt"
)
func main() {
sbuf := []byte{}
buf := []byte{144,192,192,132,136,140,144,16,0,1,1}
bbuf := []byte{144,192,192,129,132,136,140,144,192,192,1,1}
num, ret := binary.Uvarint(sbuf)
fmt.Println(num, ret)
num, ret = binary.Uvarint(buf)
fmt.Println(num, ret)
num, ret = binary.Uvarint(bbuf)
fmt.Println(num, ret)
}
- func Varint(buf []byte) (int64, int)
參數(shù)列表: buf 需要解碼的緩沖區(qū)
返回值:
1) int64 解碼的數(shù)據(jù)
2) int 解析的字節(jié)數(shù)
功能說(shuō)明:
Varint是從buf中解碼并返回一個(gè)int64的數(shù)據(jù),及解碼的字節(jié)數(shù)(>0).如果出錯(cuò),則返回?cái)?shù)據(jù)0和一個(gè)小于等于0的字節(jié)數(shù)n,其意義為:
1) n == 0: buf太小
2) n < 0: 數(shù)據(jù)太大,超出64位,且-n為已解析字節(jié)數(shù)
代碼案例
package main
import (
"encoding/binary"
"fmt"
)
func main() {
var sbuf []byte
var buf []byte = []byte{144, 192, 192, 129, 132, 136, 140, 144, 16, 0, 1, 1}
var bbuf []byte = []byte{144, 192, 192, 129, 132, 136, 140, 144, 192, 192, 1, 1}
num, ret := binary.Varint(sbuf)
fmt.Println(num, ret) //0 0
num, ret = binary.Varint(buf)
fmt.Println(num, ret) //580990878187261960 9
num, ret = binary.Varint(bbuf)
fmt.Println(num, ret) //0 -11
}
- func ReadUvarint(r io.ByteReader) (uint64, error)
參數(shù)列表:
返回值:
1) uint64 解析出的數(shù)據(jù)
2) error 返回的錯(cuò)誤
功能說(shuō)明:
ReadUvarint從r中解析并返回一個(gè)uint64類(lèi)型的數(shù)據(jù)及出現(xiàn)的錯(cuò)誤.
功能說(shuō)明:
ReadUvarint從r中解析并返回一個(gè)uint64類(lèi)型的數(shù)據(jù)及出現(xiàn)的錯(cuò)誤.
代碼案例
package main
import (
"bytes"
"encoding/binary"
"fmt"
)
func main() {
var sbuf []byte
var buf []byte = []byte{144, 192, 192, 129, 132, 136, 140, 144, 16, 0, 1, 1}
var bbuf []byte = []byte{144, 192, 192, 129, 132, 136, 140, 144, 192, 192, 1, 1}
num, err := binary.ReadUvarint(bytes.NewBuffer(sbuf))
fmt.Println(num, err) //0 EOF
num, err = binary.ReadUvarint(bytes.NewBuffer(buf))
fmt.Println(num, err) //1161981756374523920 <nil>
num, err = binary.ReadUvarint(bytes.NewBuffer(bbuf))
fmt.Println(num, err) //4620746270195064848 binary: varint overflows a 64-bit integer
}
- func ReadVarint(r io.ByteReader) (int64, error)
參數(shù)列表: r 實(shí)現(xiàn)ByteReader接口的對(duì)象
返回值:
1) int64 解析出的數(shù)據(jù)
2) error 返回的錯(cuò)誤
功能說(shuō)明:
ReadVarint從r中解析并返回一個(gè)int64類(lèi)型的數(shù)據(jù)及出現(xiàn)的錯(cuò)誤.
代碼案例
package main
import (
"bytes"
"encoding/binary"
"fmt"
)
func main() {
var sbuf []byte
var buf []byte = []byte{144, 192, 192, 129, 132, 136, 140, 144, 16, 0, 1, 1}
var bbuf []byte = []byte{144, 192, 192, 129, 132, 136, 140, 144, 192, 192, 1, 1}
num, err := binary.ReadVarint(bytes.NewBuffer(sbuf))
fmt.Println(num, err) //0 EOF
num, err = binary.ReadVarint(bytes.NewBuffer(buf))
fmt.Println(num, err) //580990878187261960 <nil>
num, err = binary.ReadVarint(bytes.NewBuffer(bbuf))
fmt.Println(num, err) //2310373135097532424 binary: varint overflows a 64-bit integer
}
三、編解碼有哪幾種方法巫糙？
編碼
- func Write(w io.Writer, order ByteOrder, data interface{}) error
- func PutUvarint(buf []byte, x uint64) int
- func PutVarint(buf []byte, x int64) int
解析
1）func Uvarint(buf []byte) (uint64, int)
2）func Varint(buf []byte) (int64, int)
3）func ReadUvarint(r io.ByteReader) (uint64, error)
4）func ReadVarint(r io.ByteReader) (int64, error)
