module std.ser

std.ser — serialization ([С §9], II.2, D-2100..D-2199).

encode<T> / decode<T> run the codec the compiler generates for T (a descriptor of the schema, walked by the runtime). The default format is the OxL binary format (protobuf 3 wire encoding, §9.3); Format.Json is the canonical protobuf JSON mapping. Repr<W> (§9.5 level 1) and Codec<T> (level 2) customise single types and fields. Level 3 (D-7620): a user format implements Format (the interface FormatSpec), is registered with register and passed as a type name. Format is the enum of the built-in formats (D-2104): the binary format, JSON, MessagePack and CBOR (D-7600).

Example:

use std.ser { encode, decode, toJson, Format }

data User {
  name: str
  age: i32
}

fn main() io {
  let bytes = encode(&User{ name: "ann", age: 31 })!
  let back = decode<User>(&bytes)!
  print("{back.name} {toJson(&back)!}")
}

ann {"name":"ann","age":31}

Типы

Функции