Struct Duration 

pub struct Duration {
    pub seconds: i32,
    pub fraction: u32,
}

Duration_t (Spec §9.4.2.2): seconds + nanoseconds.

Canonical definition lives in zerodds_qos::Duration; RTPS re-exports the type here for backward compatibility. All call sites use the qos type. DDS Duration (signed seconds + unsigned 2^-32-fractions).

The spec defines two special values:

• DURATION_INFINITE: { seconds: 0x7FFFFFFF, fraction: 0xFFFFFFFF }.
• DURATION_ZERO: { seconds: 0, fraction: 0 }.

Fields

seconds: i32

Sekundenanteil (signed 32 bit).

fraction: u32

Bruchteil-Anteil (2^-32-Sekunden).

Implementations

impl Duration

pub const INFINITE: Duration

Spec §9.3.2: DURATION_INFINITE.

pub const ZERO: Duration

Spec §9.3.2: DURATION_ZERO.

pub const fn from_secs(seconds: i32) -> Duration

Creates a Duration from a number of seconds.

pub const fn from_millis(ms: i32) -> Duration

Creates a Duration from a number of milliseconds.

Time is represented as { seconds: i32, fraction: u32 (2^-32 s) } — fraction is unsigned. Negative durations describe the time via negative seconds + positive fraction, so that (seconds + fraction*2^-32) runs continuously across 0. With div_euclid/rem_euclid the remainder always stays [0, 1000).

Examples:

• from_millis(1500) = {1, 2^31} (1.5 s).
• from_millis(-500) = {-1, 2^31} (= -1 + 0.5 = -0.5 s).
• from_millis(-1500) = {-2, 2^31} (= -2 + 0.5 = -1.5 s).

pub const fn from_micros(us: i32) -> Duration

Creates a Duration from a number of microseconds. Sub-millisecond precision is preserved via the RTPS fraction field (latency budgets, deadlines, time-based filters routinely use µs). Same negative-value convention as Self::from_millis.

pub const fn is_infinite(self) -> bool

true if self == INFINITE.

pub const fn to_nanos(self) -> u128

Converts into nanoseconds. INFINITE and negative durations return u128::MAX or saturate to 0 (the caller treats u128::MAX as “never expires”).

pub const fn is_zero(self) -> bool

true if self == ZERO.

pub fn encode_into(self, w: &mut BufferWriter) -> Result<(), EncodeError>

Wire-Encoding: { i32 seconds; u32 fraction } (8 byte).

Errors

Buffer-Overflow.

pub fn decode_from(r: &mut BufferReader<'_>) -> Result<Duration, DecodeError>

Wire-Decoding.

Errors

Buffer-Underflow.

pub fn to_bytes_le(self) -> [u8; 8]

8-byte array (LE) — useful for in-place copies in PL_CDR values.

pub fn to_bytes_be(self) -> [u8; 8]

8-byte array (BE) — for PL_CDR_BE payloads like the handshake c.pdata.

pub fn from_bytes_le(bytes: [u8; 8]) -> Duration

Aus 8-byte-LE-Array.

Trait Implementations

impl Clone for Duration

fn clone(&self) -> Duration

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Duration

impl Debug for Duration

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

Formats the value using the given formatter.

impl Default for Duration

fn default() -> Duration

Returns the “default value” for a type.

impl Eq for Duration

impl Hash for Duration

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 Duration

fn cmp(&self, other: &Duration) -> 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.

impl PartialEq for Duration

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Duration

fn partial_cmp(&self, other: &Duration) -> 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 Duration