Struct ParameterList 

pub struct ParameterList {
    pub parameters: Vec<Parameter>,
}

ParameterList = Sequenz von Parametern + Sentinel-Terminator.

Fields

parameters: Vec<Parameter>

Liste der Parameter (ohne Sentinel — der wird automatisch beim Encode angefuegt).

Implementations

impl ParameterList

pub fn new() -> Self

Leere Liste.

pub fn push(&mut self, param: Parameter)

Parameter anhaengen.

pub fn find(&self, id: u16) -> Option<&Parameter>

Erste Parameter mit id finden.

pub fn validate_must_understand<F>(&self, is_known: F) -> Result<(), WireError>

where F: Fn(u16) -> bool,

Validiert die ParameterList gegen die Must-Understand-Regel (DDSI-RTPS 2.5 §9.4.2.11.2).

Spec-Verhalten:

“If the receiver does not understand a parameter and the must_understand bit (0x4000) is set, the entire RTPS message carrying this ParameterList MUST be discarded.”

is_known ist ein Klassifikator: liefert true fuer alle PIDs, die der Receiver versteht (ohne Must-Understand- und Vendor- Bits, also masked PID).

Errors

ValueOutOfRange mit Marker-Message bei Verletzung — der Caller MUSS die Ganz-Message verwerfen.

pub fn validate_must_understand_in_data_pipeline(&self) -> Result<(), WireError>

Convenience-Wrapper um Self::validate_must_understand mit dem standard-konformen is_standard_pid-Klassifikator. Wird im Receiver-Pipeline-Hot-Path gerufen (crates/rtps/src/datagram.rs::decode_datagram), sodass die Spec-§9.4.2.11.2-Reject-Regel automatisch greift.

Vendor-Specific-PIDs (oberstes Bit gesetzt) sind explizit erlaubt — der Vendor-Bit-Pfad ueberlebt die Pruefung in validate_must_understand, weil das masked den Vendor-Bit strippt aber is_standard_pid ihn nicht zurueckaddiert; der Caller behandelt Vendor-PIDs als “kann ignoriert werden”.

Errors

ValueOutOfRange bei Verletzung — Caller verwirft die Message.

pub fn to_bytes(&self, little_endian: bool) -> Vec<u8>

Encoded zu Bytes mit der gegebenen Endianness. Padding zu 4-Byte-Boundary wird pro Value automatisch eingefuegt; der Sentinel wird angefuegt.

pub fn from_bytes(bytes: &[u8], little_endian: bool) -> Result<Self, WireError>

Decoded eine ParameterList aus Bytes. Stoppt am Sentinel.

Errors

UnexpectedEof bei truncated Eingabe; ValueOutOfRange wenn Length nicht 4-Byte-aligned ist; ValueOutOfRange wenn die Parameter-Zahl MAX_PARAMETERS uebersteigt (DoS-Cap).

Trait Implementations

impl Clone for ParameterList

fn clone(&self) -> ParameterList

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ParameterList

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

Formats the value using the given formatter.

impl Default for ParameterList

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for ParameterList

fn eq(&self, other: &ParameterList) -> 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 Eq for ParameterList

impl StructuralPartialEq for ParameterList