Skip to main content

Crate zerodds_rs

Crate zerodds_rs 

Source
Expand description

Crate zerodds-rs. Safety classification: SAFE.

zerodds-rs — idiomatische Rust-SDK-Facade.

Re-exportiert die nutzerseitig relevanten APIs aus den darunterliegenden Implementierungs-Crates (zerodds-dcps, zerodds-dcps-async, zerodds-qos, zerodds-types, zerodds-monitor, zerodds-recorder).

Anwendungen sollten diese Crate nutzen — direkter Zugriff auf zerodds-dcps etc. ist erlaubt, aber an zerodds-rs muss sich die Public-API stabilisieren.

§Beispiel

use zerodds_rs::{
    DomainParticipantFactory, DomainParticipantQos, RawBytes, TopicQos,
    PublisherQos, SubscriberQos, DataWriterQos, DataReaderQos,
};

let f = DomainParticipantFactory::instance();
let dp = f.create_participant_offline(0, DomainParticipantQos::default());
let topic = dp.create_topic::<RawBytes>("Chatter", TopicQos::default()).unwrap();
let publisher = dp.create_publisher(PublisherQos::default());
let writer = publisher
    .create_datawriter::<RawBytes>(&topic, DataWriterQos::default())
    .unwrap();
let _ = writer; // offline-Mode hat kein UDP — nur API-Smoke.

§Re-Exports

Plus Top-Level-Convenience-Re-Exports der haeufigsten Symbole.

Re-exports§

pub use zerodds_dcps as dcps;
pub use zerodds_dcps_async as aio;
pub use zerodds_qos as qos;
pub use zerodds_types as types;
pub use zerodds_monitor as monitor;
pub use zerodds_recorder as recorder;
pub use zerodds_foundation as foundation;

Structs§

DataReader
Typed DataReader — entnimmt Samples, die der RTPS-Reader fuer das Topic empfangen hat.
DataReaderQos
QoS-Set fuer einen DataReader — Spec §2.2.2.5.2.
DataWriter
Typed DataWriter — schickt Samples an alle matched Reader des Topics.
DataWriterQos
QoS-Set fuer einen DataWriter — Spec §2.2.2.4.2 (alle Policies, die am DataWriter setzbar sind).
DomainParticipant
Der Participant.
DomainParticipantFactory
Factory-Singleton.
DomainParticipantQos
QoS-Set fuer den DomainParticipant — Spec §2.2.2.2.2.
Duration
DDS Duration (signed seconds + unsigned 2^-32-fractions).
InstanceHandle
Opaker InstanceHandle_t (DDS-DCPS 1.4 §2.3.3).
Publisher
Publisher — Entity-Gruppe fuer DataWriter.
PublisherQos
QoS-Set fuer den Publisher — Spec §2.2.2.4.1.
RawBytes
Ein opaker Raw-Byte-Payload mit konfigurierbarem Type-Name (per impl von BytesPayload<T> oder via newtype).
Subscriber
Subscriber — Entity-Gruppe fuer DataReader.
SubscriberQos
QoS-Set fuer den Subscriber — Spec §2.2.2.5.1.
Topic
Typed Topic-Handle.
TopicQos
QoS-Set fuer einen Topic — Spec §2.2.2.3.2.

Enums§

DdsError
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.

Traits§

DdsType
Typ, der via DDS published/subscribed werden kann.

Type Aliases§

Result
Kurzform fuer DCPS-Ergebnisse.