QMqttTopicName Class

The QMqttTopicName class represents a MQTT topic name. More...

Header: #include <QMqttTopicName>
CMake: find_package(Qt6 REQUIRED COMPONENTS Mqtt)
target_link_libraries(mytarget PRIVATE Qt6::Mqtt)
qmake: QT += mqtt

Note: All functions in this class are reentrant.

Public Functions

QMqttTopicName(const QString &name = QString())
QMqttTopicName(const QLatin1String &name)
QMqttTopicName(const QMqttTopicName &name)
~QMqttTopicName()
bool isValid() const
int levelCount() const
QStringList levels() const
QString name() const
void setName(const QString &name)
void swap(QMqttTopicName &other)
QMqttTopicName &operator=(const QMqttTopicName &name)
bool operator!=(const QMqttTopicName &lhs, const QMqttTopicName &rhs)
bool operator<(const QMqttTopicName &lhs, const QMqttTopicName &rhs)
QDataStream &operator<<(QDataStream &out, const QMqttTopicName &name)
bool operator==(const QMqttTopicName &lhs, const QMqttTopicName &rhs)
QDataStream &operator>>(QDataStream &in, QMqttTopicName &name)

Detailed Description

QMqttTopicName is a thin wrapper around a QString providing an expressive data type for MQTT topic names. Beside the benefits of having a strong type preventing unintended misuse, QMqttTopicName provides convenient functions related to topic names like isValid() or levels().

See also QMqttTopicFilter.

Member Function Documentation

QMqttTopicName::QMqttTopicName(const QString &name = QString())

Creates a new MQTT topic name with the specified name.

QMqttTopicName::QMqttTopicName(const QLatin1String &name)

Creates a new MQTT topic name with the specified name.

QMqttTopicName::QMqttTopicName(const QMqttTopicName &name)

Creates a new MQTT topic name as a copy of name.

[noexcept] QMqttTopicName::~QMqttTopicName()

Destroys the QMqttTopicName object.

bool QMqttTopicName::isValid() const

Returns true if the topic name is valid according to the MQTT standard section 4.7, or false otherwise.

int QMqttTopicName::levelCount() const

Returns the total number of topic levels.

QStringList QMqttTopicName::levels() const

Returns the topic levels.

QString QMqttTopicName::name() const

Returns the topic name.

See also setName().

void QMqttTopicName::setName(const QString &name)

Sets the topic name to name.

See also name().

[noexcept] void QMqttTopicName::swap(QMqttTopicName &other)

Swaps the MQTT topic name other with this MQTT topic name. This operation is very fast and never fails.

QMqttTopicName &QMqttTopicName::operator=(const QMqttTopicName &name)

Assigns the MQTT topic name name to this object, and returns a reference to the copy.

Related Non-Members

[noexcept] bool operator!=(const QMqttTopicName &lhs, const QMqttTopicName &rhs)

Returns true if the topic names lhs and rhs are different, otherwise returns false.

[noexcept] bool operator<(const QMqttTopicName &lhs, const QMqttTopicName &rhs)

Returns true if the topic name lhs is lexically less than the topic name rhs; otherwise returns false.

QDataStream &operator<<(QDataStream &out, const QMqttTopicName &name)

Writes the topic name name to the stream out and returns a reference to the stream.

See also Format of the QDataStream operators.

[noexcept] bool operator==(const QMqttTopicName &lhs, const QMqttTopicName &rhs)

Returns true if the topic names lhs and rhs are equal, otherwise returns false.

QDataStream &operator>>(QDataStream &in, QMqttTopicName &name)

Reads a topic name into name from the stream in and returns a reference to the stream.

See also Format of the QDataStream operators.

© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.