.. first line of object.rst template
.. first line of pou-object.rst template
.. first line of fun-object.rst template
.. _`.fld-FinderOpta.fld-Functions.fld-Read.MQTT_ReadTopicReal`:


.. index::
   single: MQTT_ReadTopicReal

.. _`MQTT_ReadTopicReal`:

``MQTT_ReadTopicReal`` (FUN)
----------------------------

FUNCTION MQTT_ReadTopicReal : WORD




This function subscribes to the specified MQTT topic and returns published messages as real numbers.

The output ``valid`` is set to ``TRUE`` when a publication occurs
on the topic and the message payload is stored into ``value``.





InOut:
    +--------+------------------------+-----------------+------------------------------------------------------------+
    | Scope  | Name                   | Type            | Comment                                                    |
    +========+========================+=================+============================================================+
    | Return | ``MQTT_ReadTopicReal`` | ``WORD``        | Status code returned by the runtime (0 means "no errors"). |
    +--------+------------------------+-----------------+------------------------------------------------------------+
    | Inout  | ``id``                 | ``WORD``        | Operation identifier used by the runtime.                  |
    +--------+------------------------+-----------------+------------------------------------------------------------+
    | Input  | ``topic``              | ``STRING(127)`` | MQTT topic name.                                           |
    +        +------------------------+-----------------+------------------------------------------------------------+
    |        | ``qos``                | ``WORD``        | Quality of Service level.                                  |
    +--------+------------------------+-----------------+------------------------------------------------------------+
    | Output | ``value``              | ``REAL``        | Real value published on the topic.                         |
    +        +------------------------+-----------------+------------------------------------------------------------+
    |        | ``valid``              | ``BOOL``        | ``TRUE`` when a valid value has been received.             |
    +--------+------------------------+-----------------+------------------------------------------------------------+







.. last line of fun-object.rst template
.. last line of pou-object.rst template
.. last line of object.rst template



