Skip to main content

DeserializeAndAllocate

Read a borrowed &'a Value by reading an owned Value and allocating it through the context.

Overview​

In cgp-serde, a serialization library built with Context-Generic Programming (CGP), DeserializeAndAllocate lets a deserialized value hold references to other deserialized values, such as a Vec<&'a Coord>, without the references pointing into the input. It reads each value as an owned Value, then asks the context, the type whose wiring holds the application's choices, to allocate it with CanAlloc, and returns the reference. It knows nothing about where the value is stored, which is the context's choice.

Definition​

#[cgp_impl(new DeserializeAndAllocate)]
#[uses(CanAlloc<'a, Value>, CanDeserializeValue<'de, Value>)]
impl<'de, 'a, Value> ValueDeserializer<'de, &'a Value> { ... }

Usage​

Import it from cgp_serde_alloc::providers, and wire it for the reference type, beside an entry for the owned type and an allocator. From the repository's arena example:

AllocatorComponent:
AllocateWithArena,

@ValueDeserializerComponent.[
Coord,
<'b> Payload<'b>,
]:
DeserializeRecordFields,

@ValueDeserializerComponent.<'b> &'b Coord:
DeserializeAndAllocate,

Behavior​

The provider reads the owned value through the context, passes it to alloc, and returns the reference the allocator gives back. The reference's lifetime 'a is separate from the input's 'de, so the value outlives the input and borrows from the allocator instead.

Context dependencies​

CanDeserializeValue<'de, Value> for the owned type, and CanAlloc<'a, Value>. Without an allocator entry, the context fails to compile with a missing AllocatorComponent entry, as the debugging guide shows.

Pairing​

It reads only. A reference is written with SerializeDeref.

When to use it​

Reach for DeserializeAndAllocate when deserialized values should share storage, such as many small values in one arena rather than a Box each.

The ideas behind it​

  • Context services: a deserializer taking a service from its context, in layers.

Source​


An AI agent wrote this page using the CGP knowledge base. Its content was verified against the project's source. See How AI is used in this project.