// 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 translation between // unsigned integer values and byte sequences. package binary import ( "math"; "io"; "os"; "reflect"; ) // 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; } // This is byte instead of struct{} so that it can be compared, // allowing, e.g., order == binary.LittleEndian. type unused byte var LittleEndian ByteOrder = littleEndian(0) var BigEndian ByteOrder = bigEndian(0) type littleEndian unused func (littleEndian) Uint16(b []byte) uint16 { return uint16(b[0]) | uint16(b[1])<<8 } func (littleEndian) PutUint16(b []byte, v uint16) { b[0] = byte(v); b[1] = byte(v >> 8); } func (littleEndian) Uint32(b []byte) uint32 { return uint32(b[0]) | uint32(b[1])<<8 | uint32(b[2])<<16 | uint32(b[3])<<24 } func (littleEndian) PutUint32(b []byte, v uint32) { b[0] = byte(v); b[1] = byte(v >> 8); b[2] = byte(v >> 16); b[3] = byte(v >> 24); } func (littleEndian) Uint64(b []byte) uint64 { return uint64(b[0]) | uint64(b[1])<<8 | uint64(b[2])<<16 | uint64(b[3])<<24 | uint64(b[4])<<32 | uint64(b[5])<<40 | uint64(b[6])<<48 | uint64(b[7])<<56 } func (littleEndian) PutUint64(b []byte, v uint64) { b[0] = byte(v); b[1] = byte(v >> 8); b[2] = byte(v >> 16); b[3] = byte(v >> 24); b[4] = byte(v >> 32); b[5] = byte(v >> 40); b[6] = byte(v >> 48); b[7] = byte(v >> 56); } func (littleEndian) String() string { return "LittleEndian" } func (littleEndian) GoString() string { return "binary.LittleEndian" } type bigEndian unused func (bigEndian) Uint16(b []byte) uint16 { return uint16(b[1]) | uint16(b[0])<<8 } func (bigEndian) PutUint16(b []byte, v uint16) { b[0] = byte(v >> 8); b[1] = byte(v); } func (bigEndian) Uint32(b []byte) uint32 { return uint32(b[3]) | uint32(b[2])<<8 | uint32(b[1])<<16 | uint32(b[0])<<24 } func (bigEndian) PutUint32(b []byte, v uint32) { b[0] = byte(v >> 24); b[1] = byte(v >> 16); b[2] = byte(v >> 8); b[3] = byte(v); } func (bigEndian) Uint64(b []byte) uint64 { return uint64(b[7]) | uint64(b[6])<<8 | uint64(b[5])<<16 | uint64(b[4])<<24 | uint64(b[3])<<32 | uint64(b[2])<<40 | uint64(b[1])<<48 | uint64(b[0])<<56 } func (bigEndian) PutUint64(b []byte, v uint64) { b[0] = byte(v >> 56); b[1] = byte(v >> 48); b[2] = byte(v >> 40); b[3] = byte(v >> 32); b[4] = byte(v >> 24); b[5] = byte(v >> 16); b[6] = byte(v >> 8); b[7] = byte(v); } func (bigEndian) String() string { return "BigEndian" } func (bigEndian) GoString() string { return "binary.BigEndian" } // Read reads structured binary data from r into data. // Data must be a pointer to a fixed-size value. // A fixed-size value is either a fixed-size integer // (int8, uint8, int16, uint16, ...) 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 Read(r io.Reader, order ByteOrder, data interface{}) os.Error { v := reflect.NewValue(data).(*reflect.PtrValue).Elem(); size := sizeof(v.Type()); if size < 0 { return os.NewError("binary.Read: invalid type " + v.Type().String()) } d := &decoder{order: order, buf: make([]byte, size)}; if _, err := io.ReadFull(r, d.buf); err != nil { return err } d.value(v); return nil; } // 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 integer // (int8, uint8, int16, uint16, ...) 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. func Write(w io.Writer, order ByteOrder, data interface{}) os.Error { v := reflect.Indirect(reflect.NewValue(data)); size := sizeof(v.Type()); if size < 0 { return os.NewError("binary.Write: invalid type " + v.Type().String()) } buf := make([]byte, size); e := &encoder{order: order, buf: buf}; e.value(v); _, err := w.Write(buf); return err; } func sizeof(t reflect.Type) int { switch t := t.(type) { case *reflect.ArrayType: n := sizeof(t.Elem()); if n < 0 { return -1 } return t.Len() * n; case *reflect.StructType: sum := 0; for i, n := 0, t.NumField(); i < n; i++ { s := sizeof(t.Field(i).Type); if s < 0 { return -1 } sum += s; } return sum; case *reflect.Uint8Type: return 1 case *reflect.Uint16Type: return 2 case *reflect.Uint32Type: return 4 case *reflect.Uint64Type: return 8 case *reflect.Int8Type: return 1 case *reflect.Int16Type: return 2 case *reflect.Int32Type: return 4 case *reflect.Int64Type: return 8 case *reflect.Float32Type: return 4 case *reflect.Float64Type: return 8 } return -1; } type decoder struct { order ByteOrder; buf []byte; } type encoder struct { order ByteOrder; buf []byte; } func (d *decoder) uint8() uint8 { x := d.buf[0]; d.buf = d.buf[1:]; return x; } func (e *encoder) uint8(x uint8) { e.buf[0] = x; e.buf = e.buf[1:]; } func (d *decoder) uint16() uint16 { x := d.order.Uint16(d.buf[0:2]); d.buf = d.buf[2:]; return x; } func (e *encoder) uint16(x uint16) { e.order.PutUint16(e.buf[0:2], x); e.buf = e.buf[2:]; } func (d *decoder) uint32() uint32 { x := d.order.Uint32(d.buf[0:4]); d.buf = d.buf[4:]; return x; } func (e *encoder) uint32(x uint32) { e.order.PutUint32(e.buf[0:4], x); e.buf = e.buf[4:]; } func (d *decoder) uint64() uint64 { x := d.order.Uint64(d.buf[0:8]); d.buf = d.buf[8:]; return x; } func (e *encoder) uint64(x uint64) { e.order.PutUint64(e.buf[0:8], x); e.buf = e.buf[8:]; } func (d *decoder) int8() int8 { return int8(d.uint8()) } func (e *encoder) int8(x int8) { e.uint8(uint8(x)) } func (d *decoder) int16() int16 { return int16(d.uint16()) } func (e *encoder) int16(x int16) { e.uint16(uint16(x)) } func (d *decoder) int32() int32 { return int32(d.uint32()) } func (e *encoder) int32(x int32) { e.uint32(uint32(x)) } func (d *decoder) int64() int64 { return int64(d.uint64()) } func (e *encoder) int64(x int64) { e.uint64(uint64(x)) } func (d *decoder) value(v reflect.Value) { switch v := v.(type) { case *reflect.ArrayValue: l := v.Len(); for i := 0; i < l; i++ { d.value(v.Elem(i)) } case *reflect.StructValue: l := v.NumField(); for i := 0; i < l; i++ { d.value(v.Field(i)) } case *reflect.Uint8Value: v.Set(d.uint8()) case *reflect.Uint16Value: v.Set(d.uint16()) case *reflect.Uint32Value: v.Set(d.uint32()) case *reflect.Uint64Value: v.Set(d.uint64()) case *reflect.Int8Value: v.Set(d.int8()) case *reflect.Int16Value: v.Set(d.int16()) case *reflect.Int32Value: v.Set(d.int32()) case *reflect.Int64Value: v.Set(d.int64()) case *reflect.Float32Value: v.Set(math.Float32frombits(d.uint32())) case *reflect.Float64Value: v.Set(math.Float64frombits(d.uint64())) } } func (e *encoder) value(v reflect.Value) { switch v := v.(type) { case *reflect.ArrayValue: l := v.Len(); for i := 0; i < l; i++ { e.value(v.Elem(i)) } case *reflect.StructValue: l := v.NumField(); for i := 0; i < l; i++ { e.value(v.Field(i)) } case *reflect.Uint8Value: e.uint8(v.Get()) case *reflect.Uint16Value: e.uint16(v.Get()) case *reflect.Uint32Value: e.uint32(v.Get()) case *reflect.Uint64Value: e.uint64(v.Get()) case *reflect.Int8Value: e.int8(v.Get()) case *reflect.Int16Value: e.int16(v.Get()) case *reflect.Int32Value: e.int32(v.Get()) case *reflect.Int64Value: e.int64(v.Get()) case *reflect.Float32Value: e.uint32(math.Float32bits(v.Get())) case *reflect.Float64Value: e.uint64(math.Float64bits(v.Get())) } }