Struct VcEpochUsage 

pub struct VcEpochUsage { /* private fields */ }

Available on crate feature extensions-draft and crate feature virtual-clients-draft and (32-bit or 64-bit) only.

The set of derivation epochs the author of a commit still uses.

Entries are unique and sorted by the TLS serialization of their epoch_id. That order is a canonical encoding rule only. It says nothing about the order in which the derivation epochs were created or should be used.

Implementations

impl VcEpochUsage

pub fn new( epoch_ids: impl IntoIterator<Item = EpochId>, ) -> Result<Self, VcCommitDataError>

Build a usage declaration covering epoch_ids.

The epochs are a set, so the caller may pass them in any order and may repeat them. Duplicates are dropped and the entries are put into the canonical order.

pub fn empty() -> Self

Build a usage declaration covering no epoch at all.

This is not the same as omitting the declaration: it retires every epoch the author declared before.

pub fn in_use_epochs(&self) -> &[VcEpochReference]

The entries in canonical order.

pub fn epoch_ids(&self) -> impl Iterator<Item = &EpochId>

The referenced epochs in canonical order.

pub fn is_empty(&self) -> bool

Returns true if no epoch is declared as in use.

Trait Implementations

impl Clone for VcEpochUsage

fn clone(&self) -> VcEpochUsage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VcEpochUsage

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

Formats the value using the given formatter.

impl DeserializeBytes for VcEpochUsage

fn tls_deserialize_bytes(bytes: &[u8]) -> Result<(Self, &[u8]), Error>

This function deserializes the bytes from the provided a &[u8] and returns the populated struct, as well as the remaining slice.

fn tls_deserialize_exact_bytes(bytes: &[u8]) -> Result<Self, Error>

where Self: Sized,

This function deserializes the provided bytes and returns the populated struct. All bytes must be consumed.

impl Eq for VcEpochUsage

impl PartialEq for VcEpochUsage

fn eq(&self, other: &VcEpochUsage) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for VcEpochUsage

fn tls_serialize<W: Write>(&self, writer: &mut W) -> Result<usize, Error>

Available on crate feature std only.

Serialize self and write it to the writer. The function returns the number of bytes written to writer.

fn tls_serialize_detached(&self) -> Result<Vec<u8>, Error>

Available on crate feature std only.

Serialize self and return it as a byte vector.

impl Serialize for &VcEpochUsage

fn tls_serialize<W: Write>(&self, writer: &mut W) -> Result<usize, Error>

Available on crate feature std only.

Serialize self and write it to the writer. The function returns the number of bytes written to writer.

fn tls_serialize_detached(&self) -> Result<Vec<u8>, Error>

Available on crate feature std only.

Serialize self and return it as a byte vector.

impl Size for VcEpochUsage

fn tls_serialized_len(&self) -> usize

impl Size for &VcEpochUsage

fn tls_serialized_len(&self) -> usize

impl StructuralPartialEq for VcEpochUsage