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
crate::dcps— synchrone DCPS-Surface (zerodds_dcps::*).crate::aio— async DCPS (zerodds_dcps_async::*).crate::qos— alle 22 QoS-Policies (zerodds_qos::*).crate::types— IDL-/XTypes-Typsystem (zerodds_types::*).crate::monitor— Statistics + Built-in DCPS-Monitor.crate::recorder— Sample-Recording + -Replay.
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§
- Data
Reader - Typed DataReader — entnimmt Samples, die der RTPS-Reader fuer das Topic empfangen hat.
- Data
Reader Qos - QoS-Set fuer einen
DataReader— Spec §2.2.2.5.2. - Data
Writer - Typed DataWriter — schickt Samples an alle matched Reader des Topics.
- Data
Writer Qos - QoS-Set fuer einen
DataWriter— Spec §2.2.2.4.2 (alle Policies, die am DataWriter setzbar sind). - Domain
Participant - Der Participant.
- Domain
Participant Factory - Factory-Singleton.
- Domain
Participant Qos - QoS-Set fuer den
DomainParticipant— Spec §2.2.2.2.2. - Duration
- DDS Duration (signed seconds + unsigned 2^-32-fractions).
- Instance
Handle - Opaker
InstanceHandle_t(DDS-DCPS 1.4 §2.3.3). - Publisher
- Publisher — Entity-Gruppe fuer DataWriter.
- Publisher
Qos - QoS-Set fuer den
Publisher— Spec §2.2.2.4.1. - RawBytes
- Ein opaker Raw-Byte-Payload mit konfigurierbarem Type-Name (per
implvonBytesPayload<T>oder via newtype). - Subscriber
- Subscriber — Entity-Gruppe fuer DataReader.
- Subscriber
Qos - QoS-Set fuer den
Subscriber— Spec §2.2.2.5.1. - Topic
- Typed Topic-Handle.
- Topic
Qos - 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 allerdingsRETCODE_OKweg (stattdessenResult::Ok) und mergenBAD_PARAMETER+PRECONDITION_NOT_METwo die Unterscheidung nichts hilft.
Traits§
- DdsType
- Typ, der via DDS published/subscribed werden kann.
Type Aliases§
- Result
- Kurzform fuer DCPS-Ergebnisse.