Struct QuarterStreamId 

pub struct QuarterStreamId(/* private fields */);

Available on crate features http and std only.

The Quarter Stream ID prefix of an HTTP/3 datagram (RFC 9297 §2.1).

It names the client-initiated bidirectional request stream the datagram belongs to, divided by four. Values above 2^60 - 1 cannot name a legal stream and are rejected on construction.

Implementations

impl QuarterStreamId

pub const MAX: QuarterStreamId

The largest legal value, 2^60 - 1 (RFC 9297 §2.1).

pub const fn new(value: u64) -> Result<QuarterStreamId, InvalidQuarterStreamId>

Construct from its raw value.

pub fn from_request_stream( stream: StreamId, ) -> Result<QuarterStreamId, InvalidQuarterStreamId>

The Quarter Stream ID of a request stream, which must be client-initiated bidirectional.

pub const fn value(self) -> u64

The raw value.

pub fn request_stream(self) -> StreamId

The associated request stream.

pub fn size(self) -> usize

Encoded length of this prefix.

pub fn encode<B>(self, dst: &mut B)

where B: BufMut,

Append the prefix to dst.

pub fn split_datagram( datagram: Bytes, ) -> Result<(QuarterStreamId, Bytes), InvalidQuarterStreamId>

Split a received QUIC DATAGRAM payload into its Quarter Stream ID and HTTP datagram payload. The payload shares datagram’s storage.

Both a truncated prefix and a value above Self::MAX are connection errors of type H3_DATAGRAM_ERROR.

Trait Implementations

impl Clone for QuarterStreamId

fn clone(&self) -> QuarterStreamId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for QuarterStreamId

impl Debug for QuarterStreamId

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

Formats the value using the given formatter.

impl Eq for QuarterStreamId

impl Hash for QuarterStreamId

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

where __H: Hasher,

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 Ord for QuarterStreamId

fn cmp(&self, other: &QuarterStreamId) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for QuarterStreamId

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for QuarterStreamId

fn partial_cmp(&self, other: &QuarterStreamId) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for QuarterStreamId