15.2.10. RTPSDomain¶
-
class
eprosima::fastrtps::rtps::RTPSDomain¶ Class RTPSDomain,it manages the creation and destruction of RTPSParticipant RTPSWriter and RTPSReader. It stores a list of all created RTPSParticipant. Is has only static methods.
Public Static Functions
-
void
stopAll()¶ Method to shut down all RTPSParticipants, readers, writers, etc. It must be called at the end of the process to avoid memory leaks. It also shut downs the DomainRTPSParticipant.
-
RTPSParticipant *
createParticipant(uint32_t domain_id, const RTPSParticipantAttributes &attrs, RTPSParticipantListener *plisten = nullptr)¶ Create a RTPSParticipant.
- Return
Pointer to the RTPSParticipant.
- Parameters
domain_id: DomainId to be used by the RTPSParticipant (80 by default).attrs: RTPSParticipant Attributes.plisten: Pointer to the ParticipantListener.
-
RTPSParticipant *
createParticipant(uint32_t domain_id, bool enabled, const RTPSParticipantAttributes &attrs, RTPSParticipantListener *plisten = nullptr)¶ Create a RTPSParticipant.
- Return
Pointer to the RTPSParticipant.
- Parameters
domain_id: DomainId to be used by the RTPSParticipant (80 by default).enabled: True if the RTPSParticipant should be enabled on creation. False if it will be enabled later with RTPSParticipant::enable()attrs: RTPSParticipant Attributes.plisten: Pointer to the ParticipantListener.
-
RTPSWriter *
createRTPSWriter(RTPSParticipant *p, WriterAttributes &watt, WriterHistory *hist, WriterListener *listen = nullptr)¶ Create a RTPSWriter in a participant.
- Return
Pointer to the created RTPSWriter.
- Parameters
p: Pointer to the RTPSParticipant.watt: Writer Attributes.hist: Pointer to the WriterHistory.listen: Pointer to the WriterListener.
Create a RTPSWriter in a participant using a custom payload pool.
- Return
Pointer to the created RTPSWriter.
- Parameters
p: Pointer to the RTPSParticipant.watt: Writer Attributes.payload_pool: Shared pointer to the IPayloadPoolhist: Pointer to the WriterHistory.listen: Pointer to the WriterListener.
-
bool
removeRTPSWriter(RTPSWriter *writer)¶ Remove a RTPSWriter.
- Return
True if correctly removed.
- Parameters
writer: Pointer to the writer you want to remove.
-
RTPSReader *
createRTPSReader(RTPSParticipant *p, ReaderAttributes &ratt, ReaderHistory *hist, ReaderListener *listen = nullptr)¶ Create a RTPSReader in a participant.
- Return
Pointer to the created RTPSReader.
- Parameters
p: Pointer to the RTPSParticipant.ratt: Reader Attributes.hist: Pointer to the ReaderHistory.listen: Pointer to the ReaderListener.
Create a RTPSWriter in a participant using a custom payload pool.
- Return
Pointer to the created RTPSReader.
- Parameters
p: Pointer to the RTPSParticipant.ratt: Reader Attributes.payload_pool: Shared pointer to the IPayloadPoolhist: Pointer to the ReaderHistory.listen: Pointer to the ReaderListener.
-
bool
removeRTPSReader(RTPSReader *reader)¶ Remove a RTPSReader.
- Return
True if correctly removed.
- Parameters
reader: Pointer to the reader you want to remove.
-
bool
removeRTPSParticipant(RTPSParticipant *p)¶ Remove a RTPSParticipant and delete all its associated Writers, Readers, resources, etc.
- Return
True if correct.
- Parameters
[in] p: Pointer to the RTPSParticipant;
-
void
setMaxRTPSParticipantId(uint32_t maxRTPSParticipantId)¶ Set the maximum RTPSParticipantID.
- Parameters
maxRTPSParticipantId: ID.
-
RTPSParticipant *
clientServerEnvironmentCreationOverride(uint32_t domain_id, bool enabled, const RTPSParticipantAttributes &attrs, RTPSParticipantListener *listen)¶ Creates a RTPSParticipant as default server or client if ROS_MASTER_URI environment variable is set.
- Return
Pointer to the RTPSParticipant.
- Parameters
domain_id: DDS domain associatedenabled: True if the RTPSParticipant should be enabled on creation. False if it will be enabled later with RTPSParticipant::enable()attrs: RTPSParticipant Attributes.listen: Pointer to the ParticipantListener.
-
void