Struct PitToken 

pub struct PitToken(pub u64);

A stable, cheaply-copyable reference to a PIT entry.

Computed as a hash of (Name, Option) — safe to copy across tasks and await points without lifetime concerns.

Internally uses a two-phase hash: name components are hashed into a single u64 via NameHashes, then combined with selector and forwarding-hint hashes. This lets NameHashes pre-compute the name hash once at decode and reuse it across all PIT probes — eliminating per-probe re-hashing in PitMatchStage (which may probe 5 + 3*(N-1) combinations).

Tuple Fields

0: u64

Implementations

impl PitToken

pub fn from_interest(name: &Name, selector: Option<&Selector>) -> Self

Build a PIT token from Interest fields.

Per RFC 8569 §4.2, PIT aggregation uses (Name, Selectors, ForwardingHint) as the key.

pub fn from_interest_full( name: &Name, selector: Option<&Selector>, forwarding_hint: Option<&[Arc<Name>]>, ) -> Self

Build a PIT token including ForwardingHint for correct aggregation.

pub fn from_name_hash( name_hash: u64, selector: Option<&Selector>, forwarding_hint: Option<&[Arc<Name>]>, ) -> Self

Build a PIT token from a pre-computed name hash.

Use with NameHashes::full_hash or NameHashes::prefix_hash to avoid re-hashing name components on every probe.

Trait Implementations

impl Clone for PitToken

fn clone(&self) -> PitToken

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PitToken

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

Formats the value using the given formatter.

impl Hash for PitToken

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for PitToken

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for PitToken

impl Eq for PitToken

impl StructuralPartialEq for PitToken