File: buffer.go

package info (click to toggle)
golang-github-mdlayher-dhcp6 0.0~git20190311.2a67805-2
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, forky, sid, trixie
  • size: 400 kB
  • sloc: makefile: 3
file content (140 lines) | stat: -rw-r--r-- 2,955 bytes parent folder | download
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
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
package buffer

import (
	"encoding/binary"
)

var order = binary.BigEndian

// Buffer encapsulates marshaling unsigned integer and byte slice values.
type Buffer struct {
	// data is the underlying data.
	data []byte
}

// New consumes b for marshaling or unmarshaling.
func New(b []byte) *Buffer {
	return &Buffer{b}
}

// append appends n bytes to the Buffer and returns a slice pointing to the
// newly appended bytes.
func (b *Buffer) append(n int) []byte {
	b.data = append(b.data, make([]byte, n)...)
	return b.data[len(b.data)-n:]
}

// Data is unconsumed data remaining in the Buffer.
func (b *Buffer) Data() []byte {
	return b.data
}

// Remaining consumes and returns a copy of all remaining bytes in the Buffer.
func (b *Buffer) Remaining() []byte {
	p := b.Consume(len(b.Data()))
	cp := make([]byte, len(p))
	copy(cp, p)
	return cp
}

// consume consumes n bytes from the Buffer. It returns nil, false if there
// aren't enough bytes left.
func (b *Buffer) consume(n int) ([]byte, bool) {
	if !b.Has(n) {
		return nil, false
	}
	rval := b.data[:n]
	b.data = b.data[n:]
	return rval, true
}

// Consume consumes n bytes from the Buffer. It returns nil if there aren't
// enough bytes left.
func (b *Buffer) Consume(n int) []byte {
	v, ok := b.consume(n)
	if !ok {
		return nil
	}
	return v
}

// Has returns true if n bytes are available.
func (b *Buffer) Has(n int) bool {
	return len(b.data) >= n
}

// Len returns the length of the remaining bytes.
func (b *Buffer) Len() int {
	return len(b.data)
}

// Read8 reads a byte from the Buffer.
func (b *Buffer) Read8() uint8 {
	v, ok := b.consume(1)
	if !ok {
		return 0
	}
	return uint8(v[0])
}

// Read16 reads a 16-bit value from the Buffer.
func (b *Buffer) Read16() uint16 {
	v, ok := b.consume(2)
	if !ok {
		return 0
	}
	return order.Uint16(v)
}

// Read32 reads a 32-bit value from the Buffer.
func (b *Buffer) Read32() uint32 {
	v, ok := b.consume(4)
	if !ok {
		return 0
	}
	return order.Uint32(v)
}

// Read64 reads a 64-bit value from the Buffer.
func (b *Buffer) Read64() uint64 {
	v, ok := b.consume(8)
	if !ok {
		return 0
	}
	return order.Uint64(v)
}

// ReadBytes reads exactly len(p) values from the Buffer.
func (b *Buffer) ReadBytes(p []byte) {
	copy(p, b.Consume(len(p)))
}

// Write8 writes a byte to the Buffer.
func (b *Buffer) Write8(v uint8) {
	b.append(1)[0] = byte(v)
}

// Write16 writes a 16-bit value to the Buffer.
func (b *Buffer) Write16(v uint16) {
	order.PutUint16(b.append(2), v)
}

// Write32 writes a 32-bit value to the Buffer.
func (b *Buffer) Write32(v uint32) {
	order.PutUint32(b.append(4), v)
}

// Write64 writes a 64-bit value to the Buffer.
func (b *Buffer) Write64(v uint64) {
	order.PutUint64(b.append(8), v)
}

// WriteN returns a newly appended n-size Buffer to write to.
func (b *Buffer) WriteN(n int) []byte {
	return b.append(n)
}

// WriteBytes writes p to the Buffer.
func (b *Buffer) WriteBytes(p []byte) {
	copy(b.append(len(p)), p)
}