#include <qos.hpp>

Inheritance diagram for rclcpp::QoS:

[legend]

Public Member Functions
constexpr bool	avoid_ros_namespace_conventions () const
	Whether to skip the `/rt/` ROS topic-name prefix.

constexpr QoS &	avoid_ros_namespace_conventions (bool on)

constexpr QoS &	best_effort ()
	Set reliability to `BEST_EFFORT` (fire-and-forget; default for sensors).

constexpr Duration	deadline () const
	The deadline window. `Duration()` (zero) = infinite.

constexpr QoS &	deadline (const Duration &d)

constexpr int	depth () const
	Configured queue depth (only meaningful for `KEEP_LAST`).

constexpr DurabilityPolicy	durability () const
	The durability policy.

constexpr QoS &	durability_volatile ()
	Set durability to `VOLATILE` — late joiners get nothing (default).

constexpr HistoryPolicy	history () const
	The history policy.

constexpr QoS &	keep_all ()
	Use `KEEP_ALL` history (bounded by transport).

constexpr QoS &	keep_last (int depth)

constexpr Duration	lifespan () const
	The lifespan window. `Duration()` (zero) = infinite.

constexpr QoS &	lifespan (const Duration &d)

constexpr LivelinessPolicy	liveliness () const
	The liveliness policy kind.

constexpr QoS &	liveliness (LivelinessPolicy kind)

constexpr Duration	liveliness_lease_duration () const
	The liveliness lease window. `Duration()` (zero) = infinite.

constexpr QoS &	liveliness_lease_duration (const Duration &d)

constexpr	QoS ()

constexpr	QoS (::size_t depth)

constexpr ReliabilityPolicy	reliability () const
	The reliability policy.

constexpr QoS &	reliable ()
	Set reliability to `RELIABLE` (acked transport, retransmits on loss).

constexpr QoS &	transient_local ()
	Set durability to `TRANSIENT_LOCAL` — late joiners get the last value.

constexpr bool	tx_express () const
	Whether this publisher's samples bypass transport tx batching.

constexpr QoS &	tx_express (bool on)

Static Public Member Functions
static constexpr QoS	default_profile ()
	Default profile: `RELIABLE` + `VOLATILE` + `KEEP_LAST(10)`.

static constexpr QoS	sensor_data ()
	Sensor-data profile: `BEST_EFFORT` + `VOLATILE` + `KEEP_LAST(5)`.

static constexpr QoS	services ()
	Services profile: `RELIABLE` + `VOLATILE` + `KEEP_LAST(10)`.

Friends
constexpr QoS	detail::qos_from_ffi (const nros_cpp_qos_t &f)

Detailed Description

QoS profile for publishers and subscriptions.

Mirrors rclcpp::QoS with chainable setters and predefined profiles. All methods are constexpr — profiles can be computed at compile time.

Phase 108.B.7 — extended with full DDS QoS surface (deadline, lifespan, liveliness kind + lease, avoid_ros_namespace_conventions). Backends advertise per-policy support; entities created with a profile the active backend can't honour return NROS_CPP_RET_INCOMPATIBLE_QOS synchronously at create time.

Phase 379 W5 — the policy enums moved to namespace scope, the getters return them instead of int, and the three time windows take and return rclcpp::Duration instead of carrying an _ms suffix. The old spellings were deleted by phase-482 W6.

Constructor & Destructor Documentation

◆ QoS() [1/2]

constexpr rclcpp::QoS::QoS ( )

inlineconstexpr

Default QoS: reliable, volatile, keep-last(10), automatic liveliness, no deadline / lifespan / lease.

◆ QoS() [2/2]

constexpr rclcpp::QoS::QoS ( ::size_t depth )

inlineconstexpr

rclcpp's depth ctor: QoS(1) == default profile with keep-last(1). IMPLICIT, as upstream's QoS(size_t history_depth) is, so a bare depth converts wherever a profile is expected (create_publisher<M>(t, 10)). Before phase-483 this was an explicit int ctor on nros::QoS and a derived rclcpp::QoS added the implicit one; the two are one class now.

Member Function Documentation

◆ avoid_ros_namespace_conventions() [1/2]

constexpr bool rclcpp::QoS::avoid_ros_namespace_conventions ( ) const

inlineconstexpr

Whether to skip the /rt/ ROS topic-name prefix.

◆ avoid_ros_namespace_conventions() [2/2]

constexpr QoS & rclcpp::QoS::avoid_ros_namespace_conventions ( bool on )

inlineconstexpr

Skip the ROS /rt/ topic-name prefix. Off by default; enable when interoperating with non-ROS DDS endpoints.

◆ best_effort()

constexpr QoS & rclcpp::QoS::best_effort ( )

inlineconstexpr

Set reliability to BEST_EFFORT (fire-and-forget; default for sensors).

◆ deadline() [1/2]

constexpr Duration rclcpp::QoS::deadline ( ) const

inlineconstexpr

The deadline window. Duration() (zero) = infinite.

◆ deadline() [2/2]

constexpr QoS & rclcpp::QoS::deadline ( const Duration & d )

inlineconstexpr

Subscriber max-inter-arrival / publisher offered-rate. A zero or negative duration = infinite (no deadline check).

The C ABI underneath is uint32_t milliseconds, so a sub-millisecond window ROUNDS UP to 1 ms — it never truncates to 0, which the ABI reads as infinity. Above ~49.7 days it saturates. See detail::qos_window_ms.

◆ default_profile()

constexpr QoS rclcpp::QoS::default_profile ( )

staticconstexpr

Default profile: RELIABLE + VOLATILE + KEEP_LAST(10).

◆ depth()

constexpr int rclcpp::QoS::depth ( ) const

inlineconstexpr

Configured queue depth (only meaningful for KEEP_LAST).

◆ durability()

constexpr DurabilityPolicy rclcpp::QoS::durability ( ) const

inlineconstexpr

The durability policy.

◆ durability_volatile()

constexpr QoS & rclcpp::QoS::durability_volatile ( )

inlineconstexpr

Set durability to VOLATILE — late joiners get nothing (default).

◆ history()

constexpr HistoryPolicy rclcpp::QoS::history ( ) const

inlineconstexpr

The history policy.

◆ keep_all()

constexpr QoS & rclcpp::QoS::keep_all ( )

inlineconstexpr

Use KEEP_ALL history (bounded by transport).

◆ keep_last()

constexpr QoS & rclcpp::QoS::keep_last ( int depth )

inlineconstexpr

Use KEEP_LAST history with the given depth.

Parameters

depth maximum number of messages buffered per entity.

◆ lifespan() [1/2]

constexpr Duration rclcpp::QoS::lifespan ( ) const

inlineconstexpr

The lifespan window. Duration() (zero) = infinite.

◆ lifespan() [2/2]

constexpr QoS & rclcpp::QoS::lifespan ( const Duration & d )

inlineconstexpr

Sample expiry. A zero or negative duration = infinite. Same millisecond boundary as deadline().

◆ liveliness() [1/2]

constexpr LivelinessPolicy rclcpp::QoS::liveliness ( ) const

inlineconstexpr

The liveliness policy kind.

◆ liveliness() [2/2]

constexpr QoS & rclcpp::QoS::liveliness ( LivelinessPolicy kind )

inlineconstexpr

Liveliness kind. Pair with liveliness_lease_duration() for MANUAL_BY_TOPIC / MANUAL_BY_NODE. AUTOMATIC is the default.

◆ liveliness_lease_duration() [1/2]

constexpr Duration rclcpp::QoS::liveliness_lease_duration ( ) const

inlineconstexpr

The liveliness lease window. Duration() (zero) = infinite.

◆ liveliness_lease_duration() [2/2]

constexpr QoS & rclcpp::QoS::liveliness_lease_duration ( const Duration & d )

inlineconstexpr

Liveliness lease duration. A zero or negative duration = infinite. Same millisecond boundary as deadline().

◆ reliability()

constexpr ReliabilityPolicy rclcpp::QoS::reliability ( ) const

inlineconstexpr

The reliability policy.

◆ reliable()

constexpr QoS & rclcpp::QoS::reliable ( )

inlineconstexpr

Set reliability to RELIABLE (acked transport, retransmits on loss).

◆ sensor_data()

constexpr QoS rclcpp::QoS::sensor_data ( )

staticconstexpr

Sensor-data profile: BEST_EFFORT + VOLATILE + KEEP_LAST(5).

◆ services()

constexpr QoS rclcpp::QoS::services ( )

staticconstexpr

Services profile: RELIABLE + VOLATILE + KEEP_LAST(10).

◆ transient_local()

constexpr QoS & rclcpp::QoS::transient_local ( )

inlineconstexpr

Set durability to TRANSIENT_LOCAL — late joiners get the last value.

◆ tx_express() [1/2]

constexpr bool rclcpp::QoS::tx_express ( ) const

inlineconstexpr

Whether this publisher's samples bypass transport tx batching.

◆ tx_express() [2/2]

constexpr QoS & rclcpp::QoS::tx_express ( bool on )

inlineconstexpr

Phase 282 (#145) — mark this publisher "express": its samples bypass transport tx batching (sent immediately even when the batching knob is on). A transport hint for control-tier / latency-sensitive topics; ignored on subscriptions and by backends without batching.

Friends And Related Symbol Documentation

◆ detail::qos_from_ffi

constexpr QoS detail::qos_from_ffi ( const nros_cpp_qos_t & f )

friend

The documentation for this class was generated from the following file:

include/rclcpp/qos.hpp

Public Member Functions

Static Public Member Functions

Friends

Detailed Description

Constructor & Destructor Documentation

◆ QoS() [1/2]

◆ QoS() [2/2]

Member Function Documentation

◆ avoid_ros_namespace_conventions() [1/2]

◆ avoid_ros_namespace_conventions() [2/2]

◆ best_effort()

◆ deadline() [1/2]

◆ deadline() [2/2]

◆ default_profile()

◆ depth()

◆ durability()

◆ durability_volatile()

◆ history()

◆ keep_all()

◆ keep_last()

◆ lifespan() [1/2]

◆ lifespan() [2/2]

◆ liveliness() [1/2]

◆ liveliness() [2/2]

◆ liveliness_lease_duration() [1/2]

◆ liveliness_lease_duration() [2/2]

◆ reliability()

◆ reliable()

◆ sensor_data()

◆ services()

◆ transient_local()

◆ tx_express() [1/2]

◆ tx_express() [2/2]

Friends And Related Symbol Documentation

◆ detail::qos_from_ffi