Struct bincode2::Config

pub struct Config { /* private fields */ }

A configuration builder whose options Bincode will use while serializing and deserializing.

Options

Endianness: The endianness with which multi-byte integers will be read/written. default: little endian Limit: The maximum number of bytes that will be read/written in a bincode serialize/deserialize. default: unlimited

Byte Limit Details

The purpose of byte-limiting is to prevent Denial-Of-Service attacks whereby malicious attackers get bincode deserialization to crash your process by allocating too much memory or keeping a connection open for too long.

When a byte limit is set, bincode will return Err on any deserialization that goes over the limit, or any serialization that goes over the limit.

Array and String sizes

When writing a string or an array is serialized the length is written at the beginning so that the data can be deserialized. The option is a way to configure how this length is encoded. The default for both is U64.

If a string or array is attempted to be serialized that is not fit within the type specified bincode will return Err on serialization.

Implementations

impl Config

pub fn no_limit(&mut self) -> &mut Self

Sets the byte limit to be unlimited. This is the default.

pub fn limit(&mut self, limit: u64) -> &mut Self

Sets the byte limit to limit.

pub fn little_endian(&mut self) -> &mut Self

Sets the endianness to little-endian This is the default.

pub fn big_endian(&mut self) -> &mut Self

Sets the endianness to big-endian

pub fn native_endian(&mut self) -> &mut Self

Sets the endianness to the the machine-native endianness

pub fn string_length(&mut self, size: LengthOption) -> &mut Self

Sets the size used for lengths of strings

pub fn array_length(&mut self, size: LengthOption) -> &mut Self

Sets the size used for lengths of arrays

pub fn serialize<T: ?Sized + Serialize>(&self, t: &T) -> Result<Vec<u8>>

Serializes a serializable object into a Vec of bytes using this configuration

pub fn serialized_size<T: ?Sized + Serialize>(&self, t: &T) -> Result<u64>

Returns the size that an object would be if serialized using Bincode with this configuration

pub fn serialize_into<W: Write, T: ?Sized + Serialize>(
    &self,
    w: W,
    t: &T
) -> Result<()>

Serializes an object directly into a Writer using this configuration

If the serialization would take more bytes than allowed by the size limit, an error is returned and no bytes will be written into the Writer

pub fn deserialize<'a, T: Deserialize<'a>>(&self, bytes: &'a [u8]) -> Result<T>

Deserializes a slice of bytes into an instance of T using this configuration

pub fn deserialize_seed<'a, T: DeserializeSeed<'a>>(
    &self,
    seed: T,
    bytes: &'a [u8]
) -> Result<T::Value>

Deserializes a slice of bytes with state seed using this configuration.

pub fn deserialize_from<R: Read, T: DeserializeOwned>(
    &self,
    reader: R
) -> Result<T>

Deserializes an object directly from a Reader using this configuration

If this returns an Error, reader may be in an invalid state.

pub fn deserialize_from_seed<'a, R: Read, T: DeserializeSeed<'a>>(
    &self,
    seed: T,
    reader: R
) -> Result<T::Value>

Deserializes an object directly from a Reader with state seed using this configuration

If this returns an Error, reader may be in an invalid state.

pub fn deserialize_from_custom<'a, R: BincodeRead<'a>, T: DeserializeOwned>(
    &self,
    reader: R
) -> Result<T>

Deserializes an object from a custom BincodeReader using the default configuration. It is highly recommended to use deserialize_from unless you need to implement BincodeRead for performance reasons.

If this returns an Error, reader may be in an invalid state.

pub fn deserialize_from_custom_seed<'a, R: BincodeRead<'a>, T: DeserializeSeed<'a>>(
    &self,
    seed: T,
    reader: R
) -> Result<T::Value>

Deserializes an object from a custom BincodeReader with state seed using the default configuration. It is highly recommended to use deserialize_from unless you need to implement BincodeRead for performance reasons.

If this returns an Error, reader may be in an invalid state.

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Config

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.