summaryrefslogtreecommitdiff
path: root/src/pkg/encoding/hex/hex.go
blob: 32ec42e24505fee49381491f47713043771eba7d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
// Copyright 2009 The Go Authors. All rights reserved.
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.

// This package implements hexadecimal encoding and decoding.
package hex

import (
	"os";
	"strconv";
	"strings";
)

const hextable = "0123456789abcdef"

// EncodedLen returns the length of an encoding of n source bytes.
func EncodedLen(n int) int {
	return n*2;
}

// Encode encodes src into EncodedLen(len(src))
// bytes of dst.  As a convenience, it returns the number
// of bytes written to dst, but this value is always EncodedLen(len(src)).
// Encode implements hexadecimal encoding.
func Encode(src, dst []byte) int {
	for i, v := range src {
		dst[i*2] = hextable[v>>4];
		dst[i*2 + 1] = hextable[v&0x0f];
	}

	return len(src)*2;
}

// OddLengthInputError results from decoding an odd length slice.
type OddLengthInputError struct{}

func (OddLengthInputError) String() string {
	return "odd length hex string";
}

// InvalidHexCharError results from finding an invalid character in a hex string.
type InvalidHexCharError byte

func (e InvalidHexCharError) String() string {
	return "invalid hex char: " + strconv.Itoa(int(e));
}


func DecodedLen(x int) int {
	return x/2;
}

// Decode decodes src into DecodedLen(len(src)) bytes, returning the actual
// number of bytes written to dst.
//
// If Decode encounters invalid input, it returns an OddLengthInputError or an
// InvalidHexCharError.
func Decode(src, dst []byte) (int, os.Error) {
	if len(src)%2 == 1 {
		return 0, OddLengthInputError{};
	}

	for i := 0; i < len(src)/2; i++ {
		a, ok := fromHexChar(src[i*2]);
		if !ok {
			return 0, InvalidHexCharError(src[i*2]);
		}
		b, ok := fromHexChar(src[i*2 + 1]);
		if !ok {
			return 0, InvalidHexCharError(src[i*2 + 1]);
		}
		dst[i] = (a<<4)|b;
	}

	return len(src)/2, nil;
}

// fromHexChar converts a hex character into its value and a success flag.
func fromHexChar(c byte) (byte, bool) {
	switch {
	case 0 <= c && c <= '9':
		return c-'0', true;
	case 'a' <= c && c <= 'f':
		return c-'a'+10, true;
	case 'A' <= c && c <= 'F':
		return c-'A'+10, true;
	}

	return 0, false;
}

// EncodeToString returns the hexadecimal encoding of src.
func EncodeToString(src []byte) string {
	dst := make([]byte, EncodedLen(len(src)));
	Encode(src, dst);
	return string(dst);
}

// DecodeString returns the bytes represented by the hexadecimal string s.
func DecodeString(s string) ([]byte, os.Error) {
	src := strings.Bytes(s);
	dst := make([]byte, DecodedLen(len(src)));
	_, err := Decode(src, dst);
	if err != nil {
		return nil, err;
	}
	return dst, nil;
}