Struct AsVec 

pub struct AsVec;

A wrapper that serializes associative containers as a Vec of key-value pairs.

This provides faster serialization for containers like HashMap and BTreeMap by serializing the key-value pairs directly instead of building a data structure in the buffer.

It also allows &[T] to be archived like an owned Vec. However, note that &[T] cannot be deserialized this way.

Example

use std::collections::HashMap;

use rkyv::{with::AsVec, Archive};

#[derive(Archive)]
struct Example<'a> {
    #[rkyv(with = AsVec)]
    values: HashMap<String, u32>,
    #[rkyv(with = AsVec)]
    slice: &'a [u32],
}

Trait Implementations

impl<T: Archive> ArchiveWith<&[T]> for AsVec

type Archived = ArchivedVec<<T as Archive>::Archived>

The archived type of Self with F.

type Resolver = VecResolver

The resolver of a Self with F.

fn resolve_with( field: &&[T], resolver: Self::Resolver, out: Place<Self::Archived>, )

Resolves the archived type using a reference to the field type F.

impl<const A: usize> ArchiveWith<AlignedVec<A>> for AsVec

type Archived = ArchivedVec<u8>

The archived type of Self with F.

type Resolver = VecResolver

The resolver of a Self with F.

fn resolve_with( field: &AlignedVec<A>, resolver: Self::Resolver, out: Place<Self::Archived>, )

Resolves the archived type using a reference to the field type F.

impl<K: Archive, V: Archive> ArchiveWith<BTreeMap<K, V>> for AsVec

type Archived = ArchivedVec<Entry<<K as Archive>::Archived, <V as Archive>::Archived>>

The archived type of Self with F.

type Resolver = VecResolver

The resolver of a Self with F.

fn resolve_with( field: &BTreeMap<K, V>, resolver: Self::Resolver, out: Place<Self::Archived>, )

Resolves the archived type using a reference to the field type F.

impl<T: Archive> ArchiveWith<BTreeSet<T>> for AsVec

type Archived = ArchivedVec<<T as Archive>::Archived>

The archived type of Self with F.

type Resolver = VecResolver

The resolver of a Self with F.

fn resolve_with( field: &BTreeSet<T>, resolver: Self::Resolver, out: Place<Self::Archived>, )

Resolves the archived type using a reference to the field type F.

impl<K: Archive, V: Archive, H> ArchiveWith<HashMap<K, V, H>> for AsVec

type Archived = ArchivedVec<Entry<<K as Archive>::Archived, <V as Archive>::Archived>>

The archived type of Self with F.

type Resolver = VecResolver

The resolver of a Self with F.

fn resolve_with( field: &HashMap<K, V, H>, resolver: Self::Resolver, out: Place<Self::Archived>, )

Resolves the archived type using a reference to the field type F.

impl<T: Archive, H> ArchiveWith<HashSet<T, H>> for AsVec

type Archived = ArchivedVec<<T as Archive>::Archived>

The archived type of Self with F.

type Resolver = VecResolver

The resolver of a Self with F.

fn resolve_with( field: &HashSet<T, H>, resolver: Self::Resolver, out: Place<Self::Archived>, )

Resolves the archived type using a reference to the field type F.

impl Debug for AsVec

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

Formats the value using the given formatter.

impl<T, D> DeserializeWith<ArchivedVec<<T as Archive>::Archived>, BTreeSet<T>, D> for AsVec

where T: Archive + Ord, T::Archived: Deserialize<T, D>, D: Fallible + ?Sized,

fn deserialize_with( field: &ArchivedVec<T::Archived>, deserializer: &mut D, ) -> Result<BTreeSet<T>, D::Error>

Deserializes the field type F using the given deserializer.

impl<T, H, D> DeserializeWith<ArchivedVec<<T as Archive>::Archived>, HashSet<T, H>, D> for AsVec

where T: Archive + Hash + Eq, T::Archived: Deserialize<T, D>, H: BuildHasher + Default, D: Fallible + ?Sized,

fn deserialize_with( field: &ArchivedVec<T::Archived>, deserializer: &mut D, ) -> Result<HashSet<T, H>, D::Error>

Deserializes the field type F using the given deserializer.

impl<K, V, D> DeserializeWith<ArchivedVec<Entry<<K as Archive>::Archived, <V as Archive>::Archived>>, BTreeMap<K, V>, D> for AsVec

where K: Archive + Ord, V: Archive, K::Archived: Deserialize<K, D>, V::Archived: Deserialize<V, D>, D: Fallible + ?Sized,

fn deserialize_with( field: &ArchivedVec<Entry<K::Archived, V::Archived>>, deserializer: &mut D, ) -> Result<BTreeMap<K, V>, D::Error>

Deserializes the field type F using the given deserializer.

impl<K, V, H, D> DeserializeWith<ArchivedVec<Entry<<K as Archive>::Archived, <V as Archive>::Archived>>, HashMap<K, V, H>, D> for AsVec

where K: Archive + Hash + Eq, V: Archive, K::Archived: Deserialize<K, D>, V::Archived: Deserialize<V, D>, H: BuildHasher + Default, D: Fallible + ?Sized,

fn deserialize_with( field: &ArchivedVec<Entry<K::Archived, V::Archived>>, deserializer: &mut D, ) -> Result<HashMap<K, V, H>, D::Error>

Deserializes the field type F using the given deserializer.

impl<D, const A: usize> DeserializeWith<ArchivedVec<u8>, AlignedVec<A>, D> for AsVec

where D: Fallible + ?Sized,

fn deserialize_with( field: &ArchivedVec<u8>, _: &mut D, ) -> Result<AlignedVec<A>, D::Error>

Deserializes the field type F using the given deserializer.

impl<T, S> SerializeWith<&[T], S> for AsVec

where T: Serialize<S>, S: Fallible + Allocator + Writer + ?Sized,

fn serialize_with( field: &&[T], serializer: &mut S, ) -> Result<Self::Resolver, S::Error>

Serializes the field type F using the given serializer.

impl<S, const A: usize> SerializeWith<AlignedVec<A>, S> for AsVec

where S: Allocator + Fallible + Writer + ?Sized,

fn serialize_with( field: &AlignedVec<A>, serializer: &mut S, ) -> Result<Self::Resolver, S::Error>

Serializes the field type F using the given serializer.

impl<K, V, S> SerializeWith<BTreeMap<K, V>, S> for AsVec

where K: Serialize<S>, V: Serialize<S>, S: Fallible + Allocator + Writer + ?Sized,

fn serialize_with( field: &BTreeMap<K, V>, serializer: &mut S, ) -> Result<Self::Resolver, S::Error>

Serializes the field type F using the given serializer.

impl<T, S> SerializeWith<BTreeSet<T>, S> for AsVec

where T: Serialize<S>, S: Fallible + Allocator + Writer + ?Sized,

fn serialize_with( field: &BTreeSet<T>, serializer: &mut S, ) -> Result<Self::Resolver, S::Error>

Serializes the field type F using the given serializer.

impl<K, V, H, S> SerializeWith<HashMap<K, V, H>, S> for AsVec

where K: Serialize<S>, V: Serialize<S>, S: Fallible + Allocator + Writer + ?Sized,

fn serialize_with( field: &HashMap<K, V, H>, serializer: &mut S, ) -> Result<Self::Resolver, S::Error>

Serializes the field type F using the given serializer.

impl<T, H, S> SerializeWith<HashSet<T, H>, S> for AsVec

where T: Serialize<S>, S: Fallible + Allocator + Writer + ?Sized,

fn serialize_with( field: &HashSet<T, H>, serializer: &mut S, ) -> Result<Self::Resolver, S::Error>

Serializes the field type F using the given serializer.