Module bincode::serde

Available on crate feature serde only.

Expand description

Support for serde integration. Enable this with the serde feature.

To encode/decode type that implement serde’s trait, you can use:

For interop with bincode’s Decode/Encode, you can use:

For interop with bincode’s derive feature, you can use the #[bincode(with_serde)] attribute on each field that implements serde’s traits.

#[derive(Serialize, Deserialize)]
pub struct SerdeType {
    // ...
}

#[derive(Decode, Encode)]
pub struct StructWithSerde {
    #[bincode(with_serde)]
    pub serde: SerdeType,
}

#[derive(Decode, Encode)]
pub enum EnumWithSerde {
    Unit(#[bincode(with_serde)] SerdeType),
    Struct {
        #[bincode(with_serde)]
        serde: SerdeType,
    },
}

Known issues

Because bincode is a format without meta data, there are several known issues with serde’s attributes. Please do not use any of the following attributes if you plan on using bincode, or use bincode’s own derive macros.

#[serde(flatten)]
#[serde(skip)]
#[serde(skip_deserializing)]
#[serde(skip_serializing)]
#[serde(skip_serializing_if = "path")]
#[serde(tag = "...")]
#[serde(untagged)]

Using any of the above attributes can and will cause issues with bincode and will result in lost data. Consider using bincode’s own derive macro instead.

Structs

BorrowCompat

Wrapper struct that implements BorrowDecode and Encode on any type that implements serde’s Deserialize and Serialize respectively. This is mostly used on &[u8] and &str, for other types consider using Compat instead.

Compat

Wrapper struct that implements Decode and Encode on any type that implements serde’s DeserializeOwned and Serialize respectively.

Enums

DecodeError

A serde-specific error that occurred while decoding.

EncodeError

A serde-specific error that occurred while encoding.

Functions

decode_borrowed_from_slice

Decode a borrowed type from the given slice. Some parts of the decoded type are expected to be referring to the given slice

decode_from_reader

Attempt to decode a given type D from the given Reader.

decode_from_slice

Decode an owned type from the given slice. Will return the decoded type T as well as the amount of bytes that were read.

decode_from_std_readstd

Decode an owned type from the given std::io::Read.

decode_seed_from_slice

Decode a borrowed type from the given slice using a seed. Some parts of the decoded type are expected to be referring to the given slice

encode_into_slice

Encode a serde Serialize type into a given byte slice with the bincode algorithm

encode_into_std_writestd

Encode the given value into any type that implements std::io::Write, e.g. std::fs::File, with the given Config. See the config module for more information.

encode_into_writer

Encode the given value into a custom Writer.

encode_to_vecalloc

Encode a serde Serialize type into a Vec<u8> with the bincode algorithm