Struct Settings 

pub struct Settings {
    pub flags: SettingsFlags,
    pub config: SettingsConfig,
    pub observation: Option<Box<SettingsObservation>>,
}

Available on crate features http and std only.

Fields

flags: SettingsFlags

config: SettingsConfig

observation: Option<Box<SettingsObservation>>

Optional bounded wire observation. Semantic configuration is independent.

Implementations

impl Settings

pub fn ack() -> Settings

pub fn with_config(self, config: SettingsConfig) -> Settings

pub fn set_config(&mut self, config: SettingsConfig) -> &mut Settings

pub fn merge(&mut self, other: Settings)

pub fn from_ordered_entries(entries: Box<[Setting]>) -> Result<Settings, Error>

Build a SETTINGS frame from validated entries in their original wire order.

Unlike SettingsConfig, this retains unknown identifiers and repeated occurrences. Any later semantic configuration change discards the exact sequence so stale wire values cannot override the new configuration.

pub fn to_literal(&self) -> Result<Settings, Error>

Produce a validated literal non-ACK frame, retaining complete observed order.

Reject incomplete observations or semantic changes made after observation. Without an observation, preserve the explicitly configured fields and order.

pub fn load(head: Head, payload: &[u8]) -> Result<Settings, Error>

pub fn load_observed( head: Head, payload: &[u8], observe: bool, ) -> Result<Settings, Error>

Decode semantic settings without allocating optional observation data. When enabled, at most 256 ordered occurrences are retained. Exceeding the observation limit does not reject otherwise valid peer settings.

pub fn encode(&self, dst: &mut BytesMut)

pub fn encoded_entries(&self) -> impl Iterator<Item = Setting> + Clone

Iterate over the ordered entries this frame will encode, without copying.

A current literal replay retains duplicate and unknown occurrences. Otherwise entries follow the semantic configuration’s explicit/default order. This is the outgoing representation, not an incomplete observation. Semantic SettingsConfig equality deliberately ignores this order.

Trait Implementations

impl Clone for Settings

fn clone(&self) -> Settings

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Settings

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

Formats the value using the given formatter.

impl Default for Settings

fn default() -> Settings

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Settings

fn deserialize<__D>( __deserializer: __D, ) -> Result<Settings, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Settings

impl<T> From<Settings> for Frame<T>

fn from(src: Settings) -> Frame<T>

Converts to this type from the input type.

impl PartialEq for Settings

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Settings

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Settings