Package binary

import "encoding/binary"

This package implements translation between unsigned integer values and byte sequences.

Package files

func Read

func Read(r io.Reader, order ByteOrder, data interface{}) os.Error

Read reads structured binary data from r into data. Data must be a pointer to a fixed-size value or a slice of fixed-size values. A fixed-size value is either a fixed-size arithmetic type (int8, uint8, int16, float32, complex64, ...) or an array or struct containing only fixed-size values. Bytes read from r are decoded using the specified byte order and written to successive fields of the data.

func TotalSize

func TotalSize(v reflect.Value) int

func Write

func Write(w io.Writer, order ByteOrder, data interface{}) os.Error

Write writes the binary representation of data into w. Data must be a fixed-size value or a pointer to a fixed-size value. A fixed-size value is either a fixed-size arithmetic type (int8, uint8, int16, float32, complex64, ...) or an array or struct containing only fixed-size values. Bytes written to w are encoded using the specified byte order and read from successive fields of the data.

type ByteOrder

A ByteOrder specifies how to convert byte sequences into 16-, 32-, or 64-bit unsigned integers.

type ByteOrder interface {
    Uint16(b []byte) uint16
    Uint32(b []byte) uint32
    Uint64(b []byte) uint64
    PutUint16([]byte, uint16)
    PutUint32([]byte, uint32)
    PutUint64([]byte, uint64)
    String() string
}

var BigEndian ByteOrder = bigEndian(0)

var LittleEndian ByteOrder = littleEndian(0)