.. _dds_layers_publication_publisher:

Publisher
=========

.. include:: ../../../safety_manual/rules/RULE_LISTENER_OPERATION.inc
.. include:: ../../../safety_manual/rules/RULE_HANDLING_STATUS.inc

The ``Publisher`` acts on behalf of one or several :ref:`dds_layers_publication_datawriter` objects.
It serves as a container that allows grouping different DataWriter objects to manage the unprocessed callbacks through an optional :ref:`dds_layers_publication_publisherlistener`.

DataWriter objects that belong to the same Publisher do not have any other relation among each and act independently.
Specifically, a Publisher can host DataWriter objects for different :ref:`dds_layers_topic` and data types.

.. _dds_layers_publication_publisherqos:

PublisherQos
------------

``PublisherQos`` controls the behavior of the :ref:`dds_layers_publication_publisher`.
Internally it contains the following :ref:`dds_layers_infrastructure_policies` objects:

* ``entity_factory_qos`` as :ref:`entityfactoryqospolicy`
    Defines if the Publisher will automatically enable created subentities or not.

Example
^^^^^^^

.. literalinclude:: ../../../code/policies_examples/main.cpp
   :language: c++
   :dedent: 8
   :start-after: // DDS_PUBLISHER_QOS
   :end-before: //! DDS_PUBLISHER_QOS