Black Lives Matter. Support the Equal Justice Initiative.

Package hex

import "encoding/hex"
Overview
Index
Examples

Overview ▾

十六进制包实现十六进制编码和解码.

Variables

ErrLength报告尝试使用Decode或DecodeString解码奇数长度的输入. 基于流的解码器返回io.ErrUnexpectedEOF而不是ErrLength.

var ErrLength = errors.New("encoding/hex: odd length hex string")

func Decode

func Decode(dst, src []byte) (int, error)

Decode将src解码为DecodedLen(len(src))字节,返回写入dst的实际字节数.

解码期望src仅包含十六进制字符,并且src具有偶数长度. 如果输入格式错误,则Decode返回错误发生之前解码的字节数.

Example

Hello Gopher!

func DecodeString

func DecodeString(s string) ([]byte, error)

DecodeString返回由十六进制字符串s表示的字节.

DecodeString期望src仅包含十六进制字符,并且src具有偶数长度. 如果输入格式错误,则DecodeString返回错误之前解码的字节.

Example

Hello Gopher!

func DecodedLen

func DecodedLen(x int) int

DecodedLen返回x个源字节的解码长度. 具体来说,它返回x / 2.

func Dump

func Dump(data []byte) string

转储返回一个字符串,其中包含给定数据的十六进制转储. 十六进制转储的格式与命令行上" hexdump -C"的输出匹配.

Example

00000000  47 6f 20 69 73 20 61 6e  20 6f 70 65 6e 20 73 6f  |Go is an open so|
00000010  75 72 63 65 20 70 72 6f  67 72 61 6d 6d 69 6e 67  |urce programming|
00000020  20 6c 61 6e 67 75 61 67  65 2e                    | language.|

func Dumper

func Dumper(w io.Writer) io.WriteCloser

Dumper返回一个WriteCloser,它将所有已写入数据的十六进制转储写入w. 转储的格式与命令行上" hexdump -C"的输出匹配.

Example

00000000  47 6f 20 69 73 20 61 6e  20 6f 70 65 6e 20 73 6f  |Go is an open so|
00000010  75 72 63 65 20 70 72 6f  67 72 61 6d 6d 69 6e 67  |urce programming|
00000020  20 6c 61 6e 67 75 61 67  65 2e 0a 57 65 20 65 6e  | language..We en|
00000030  63 6f 75 72 61 67 65 20  61 6c 6c 20 47 6f 20 75  |courage all Go u|
00000040  73 65 72 73 20 74 6f 20  73 75 62 73 63 72 69 62  |sers to subscrib|
00000050  65 20 74 6f 20 67 6f 6c  61 6e 67 2d 61 6e 6e 6f  |e to golang-anno|
00000060  75 6e 63 65 2e                                    |unce.|

func Encode

func Encode(dst, src []byte) int

Encode将src编码为dst的EncodedLen(len(src))字节. 为方便起见,它返回写入dst的字节数,但此值始终为EncodedLen(len(src)). 编码实现十六进制编码.

Example

48656c6c6f20476f7068657221

func EncodeToString

func EncodeToString(src []byte) string

EncodeToString返回src的十六进制编码.

Example

48656c6c6f

func EncodedLen

func EncodedLen(n int) int

EncodedLen返回n个源字节的编码长度. 具体来说,它返回n * 2.

func NewDecoder 1.10

func NewDecoder(r io.Reader) io.Reader

NewDecoder返回io.Reader,该io.Reader解码r中的十六进制字符. NewDecoder期望r仅包含偶数个十六进制字符.

func NewEncoder 1.10

func NewEncoder(w io.Writer) io.Writer

NewEncoder返回一个io.Writer,它将小写的十六进制字符写入w.

type InvalidByteError

InvalidByteError值描述了十六进制字符串中无效字节导致的错误.

type InvalidByteError byte

func (InvalidByteError) Error

func (e InvalidByteError) Error() string

by  ICOPY.SITE