Enum DdsError 

#[non_exhaustive]
pub enum DdsError {
    BadParameter {
        what: &'static str,
    },
    PreconditionNotMet {
        reason: &'static str,
    },
    WireError {
        message: String,
    },
    InconsistentPolicy {
        what: &'static str,
    },
    TransportError {
        label: &'static str,
    },
    OutOfResources {
        what: &'static str,
    },
    Timeout,
    Unsupported {
        feature: &'static str,
    },
    NotAllowedBySecurity {
        what: &'static str,
    },
    IllegalOperation {
        what: &'static str,
    },
    ImmutablePolicy {
        policy: &'static str,
    },
    AlreadyDeleted,
    NoData,
    Other {
        reason: &'static str,
    },
    NotEnabled,
}

Fehler aus DCPS-Operationen. Halbwegs analog zum Spec- ReturnCode_t-Enum; wir lassen allerdings RETCODE_OK weg (stattdessen Result::Ok) und mergen BAD_PARAMETER + PRECONDITION_NOT_MET wo die Unterscheidung nichts hilft.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

BadParameter

Ungueltiger Parameter (z.B. leerer Topic-Name).

Fields

what: &'static str

Welcher Parameter, kurz.

PreconditionNotMet

Operation paesst nicht zum Entity-Zustand (z.B. write auf einen DataWriter, dessen Participant beendet wurde).

Fields

reason: &'static str

Kurze Beschreibung.

WireError

Unterliegende Wire/CDR-Operation ist gefehlschlagen.

Fields

message: String

Nachricht, statisch oder dynamisch.

InconsistentPolicy

QoS-Policy-Set nicht konsistent. Beispiel: Reliability= Best-Effort + History=KeepAll ohne resource_limits — Spec §2.2.3 nennt einige inkompatible Kombinationen.

Fields

what: &'static str

Welche Policy(s) kollidieren.

TransportError

Transport-Operation fehlgeschlagen.

Fields

label: &'static str

Statisches Label des Fehlers.

OutOfResources

Resource-Limit erreicht (max_samples, max_instances, etc.).

Fields

what: &'static str

Welches Limit.

Timeout

Timeout bei blockierender Operation (take_w_timeout, etc.).

Unsupported

Operation nicht implementiert in v1.2.

Fields

feature: &'static str

Kurz-Beschreibung.

NotAllowedBySecurity

Operation durch Security-Policy untersagt — DDS-Security 1.2 §7.3.25, DCPS 1.4 §2.2.2.1.1 ReturnCode_t = NOT_ALLOWED_BY_SECURITY. Der Permissions-/Access-Plugin hat das Lesen/Schreiben auf einem geschuetzten Topic abgelehnt; der Caller darf nicht erfahren, welches Permissions-Detail die Ursache war (Information-Leak).

Fields

what: &'static str

Kurze, sicherheits-unkritische Beschreibung.

IllegalOperation

IllegalOperation — die Operation passt strukturell nicht (z.B. write() auf einen DataReader). DCPS 1.4 §2.2.2.1.1 ReturnCode_t = ILLEGAL_OPERATION.

Fields

what: &'static str

Was nicht geht.

ImmutablePolicy

ImmutablePolicy — set_qos auf eine post-enable immutable QoS- Policy. DCPS 1.4 §2.2.2.1.1 ReturnCode_t = IMMUTABLE_POLICY.

Fields

policy: &'static str

Welche Policy.

AlreadyDeleted

AlreadyDeleted — Operation auf einer geloeschten Entity. DCPS 1.4 §2.2.2.1.1 ReturnCode_t = ALREADY_DELETED.

NoData

NoData — read/take ohne neue Samples. DCPS 1.4 §2.2.2.1.1 ReturnCode_t = NO_DATA. Wird in der Praxis oft als leerer Sample-Vec zurueckgegeben statt als Error.

Other

Error — generischer, nicht-spezifischer Fehler. DCPS 1.4 §2.2.2.1.1 ReturnCode_t = ERROR. Letzte Wahl wenn keine spezifischere Variante passt; vermeidet Information-Leak gegenueber dem Caller.

Fields

reason: &'static str

Kurze Beschreibung.

NotEnabled

NotEnabled — Operation auf einer Entity, die noch nicht via enable() aktiviert wurde. DCPS 1.4 §2.2.2.1.1 ReturnCode_t = NOT_ENABLED. §2.1.2 — Entities sind nach create_* disabled bis enable(); viele Ops MUESSEN dann NotEnabled liefern.

Implementations

impl DdsError

pub fn as_return_code(&self) -> i32

Mappt den Fehler auf den OMG ReturnCode_t-Integer-Wert (DCPS 1.4 §2.2.2.1.1). WireError und TransportError werden auf RETCODE_ERROR (1) abgebildet — das ist Spec-konform: beide sind unspezifizierte Implementations-Fehler.

Trait Implementations

impl Clone for DdsError

fn clone(&self) -> DdsError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DdsError

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

Formats the value using the given formatter.

impl Display for DdsError

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

Formats the value using the given formatter.

impl Error for DdsError

Available on crate feature std only.

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

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

Provides type-based access to context intended for error reports.

impl PartialEq for DdsError

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

impl StructuralPartialEq for DdsError