moonvar

// The fixed widths, either way round, reading nothing it was not given.
let buf = Buffer()
@fixed.write_u32(buf, 0x12345678)               // 12 34 56 78
@fixed.write_u16(buf, 0x1234, order=Little)     // 34 12
let wire = buf.to_bytes()
@fixed.read_u32(wire[:])                        // Some(305419896)
@fixed.read_u32(wire[:], at=10)                 // None, the view is shorter

// One number, in each protocol's own spelling.
@quic.encode(1337UL)                            // 45 39
@prefix.encode(1337, prefix=5)                  // 1f 9a 0a
@leb128.encode(1337UL)                          // b9 0a
@lenenc.encode(1337UL)                          // fc 39 05

#Packages

#The same number, five ways

#Reading is half of it

• Nothing read past the end. Every fixed reader checks the width it needs and answers None when the view is short. The variable-length readers raise a Refused that names the fault: Truncated, or past the ceiling the encoding allows.
• A width without writing it. Every package has size(): how many octets a value takes, without producing them. A length field has to be measured before the payload it describes is written.
• Signed values stay short. leb128.zigzag folds a negative onto an unsigned value, so -1 costs one octet rather than ten.

#Install

moon add moonbitstack/moonvar

import {
  "moonbitstack/moonvar/quic",
}

#Examples

moon run src/examples/tour
moon run src/examples/frame

#Licence