README
¶
Unsafe Binary Slices
This sub-package contains a set of typed sclices which can be useful for encoding/decoding large numerical slices faster. This is relatively unsafe and non-portable as the encoding simply copies the memory of the slice, hence disregarding byte order of the encoder/decoders. However, this lets us to avoid allocating and copying memory when encoding/decoding, making this at least 10x faster than the safe implementation.
Benchmark
BenchmarkUint64s_Safe/marshal-8 200000 9958 ns/op 1120 B/op 4 allocs/op
BenchmarkUint64s_Safe/unmarshal-8 100000 16036 ns/op 4224 B/op 4 allocs/op
BenchmarkUint64s_Unsafe/marshal-8 1000000 1261 ns/op 4209 B/op 2 allocs/op
BenchmarkUint64s_Unsafe/unmarshal-8 1000000 1559 ns/op 4224 B/op 4 allocs/op
Usage
This is a drop-in type, so simply use one of the types available in the package (Bools, Int32s, Uint64s ...) and Marshal or Unmarshal using the binary package.
// Marshal some numbers
v := Int32s{4, 5, 6, 1, 2, 3}
encoded, err := binary.Marshal(&v)
// Unmarshal the numbers
var o Int32s
err = binary.Unmarshal(b, &o)
Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Bools ¶
type Bools []bool
Bools represents a slice serialized in an unsafe, non portable manner.
func (*Bools) GetBinaryCodec ¶
GetBinaryCodec retrieves a custom binary codec.
type Float32s ¶
type Float32s []float32
Float32s represents a slice serialized in an unsafe, non portable manner.
func (*Float32s) GetBinaryCodec ¶
GetBinaryCodec retrieves a custom binary codec.
type Float64s ¶
type Float64s []float64
Float64s represents a slice serialized in an unsafe, non portable manner.
func (*Float64s) GetBinaryCodec ¶
GetBinaryCodec retrieves a custom binary codec.
type Int16s ¶
type Int16s []int16
Int16s represents a slice serialized in an unsafe, non portable manner.
func (*Int16s) GetBinaryCodec ¶
GetBinaryCodec retrieves a custom binary codec.
type Int32s ¶
type Int32s []int32
Int32s represents a slice serialized in an unsafe, non portable manner.
func (*Int32s) GetBinaryCodec ¶
GetBinaryCodec retrieves a custom binary codec.
type Int64s ¶
type Int64s []int64
Int64s represents a slice serialized in an unsafe, non portable manner.
func (*Int64s) GetBinaryCodec ¶
GetBinaryCodec retrieves a custom binary codec.
type Uint16s ¶
type Uint16s []uint16
Uint16s represents a slice serialized in an unsafe, non portable manner.
func (*Uint16s) GetBinaryCodec ¶
GetBinaryCodec retrieves a custom binary codec.
type Uint32s ¶
type Uint32s []uint32
Uint32s represents a slice serialized in an unsafe, non portable manner.
func (*Uint32s) GetBinaryCodec ¶
GetBinaryCodec retrieves a custom binary codec.
type Uint64s ¶
type Uint64s []uint64
Uint64s represents a slice serialized in an unsafe, non portable manner.
func (*Uint64s) GetBinaryCodec ¶
GetBinaryCodec retrieves a custom binary codec.
Source Files