En esta página

QMqttTopicFilter Class

La clase QMqttTopicFilter representa un filtro de temas MQTT. Más información...

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

Nota: Todas las funciones de esta clase son reentrantes.

Tipos públicos

enum MatchOption { NoMatchOption, WildcardsDontMatchDollarTopicMatchOption }
flags MatchOptions

Funciones públicas

QMqttTopicFilter(const QLatin1String &filter)
QMqttTopicFilter(const QString &filter = QString())
QMqttTopicFilter(const QMqttTopicFilter &filter)
~QMqttTopicFilter()
QString filter() const
bool isValid() const
bool match(const QMqttTopicName &name, QMqttTopicFilter::MatchOptions matchOptions = NoMatchOption) const
void setFilter(const QString &filter)
QString sharedSubscriptionName() const
void swap(QMqttTopicFilter &other)
QMqttTopicFilter &operator=(const QMqttTopicFilter &filter)
bool operator!=(const QMqttTopicFilter &lhs, const QMqttTopicFilter &rhs)
bool operator<(const QMqttTopicFilter &lhs, const QMqttTopicFilter &rhs)
QDataStream &operator<<(QDataStream &out, const QMqttTopicFilter &filter)
bool operator==(const QMqttTopicFilter &lhs, const QMqttTopicFilter &rhs)
QDataStream &operator>>(QDataStream &in, QMqttTopicFilter &filter)

Descripción detallada

QMqttTopicFilter es una sencilla envoltura alrededor de un ` QString ` que proporciona un tipo de datos expresivo para los filtros de temas MQTT. Además de las ventajas de contar con un tipo fuerte que evita un uso indebido no deseado, QMqttTopicFilter ofrece funciones prácticas relacionadas con los filtros de temas, como ` isValid()` o ` match()`.

Por ejemplo, el siguiente código no se compilaría y evitaría una posible coincidencia involuntaria y sin sentido entre dos filtros, especialmente si los nombres de las variables fueran menos expresivos:

QMqttTopicFilter globalFilter{"foo/#"};
QMqttTopicFilter specificFilter{"foo/bar"};
if (globalFilter.match(specificFilter)) {
    //...
}

Sin embargo, la usabilidad no se ve afectada, ya que el siguiente fragmento de código se compila y se ejecuta según lo esperado:

QMqttTopicFilter globalFilter{"foo/#"};
if (globalFilter.match("foo/bar")) {
    //...
}

Véase también QMqttTopicName.

Documentación sobre tipos de miembro

enum QMqttTopicFilter::MatchOption
flags QMqttTopicFilter::MatchOptions

Este valor de enumeración contiene las opciones de coincidencia para el filtro de temas.

ConstanteValorDescripción
QMqttTopicFilter::NoMatchOption0x0000No hay opciones de coincidencia configuradas.
QMqttTopicFilter::WildcardsDontMatchDollarTopicMatchOption0x0001Un comodín al principio del filtro no coincide con un nombre de tema que empiece por el signo de dólar ($).

El tipo MatchOptions es un typedef para QFlags<MatchOption>. Almacena una combinación «O» de valores de MatchOption.

Documentación de las funciones de miembro

QMqttTopicFilter::QMqttTopicFilter(const QLatin1String &filter)

Crea un nuevo filtro de temas MQTT con el « filter » especificado.

QMqttTopicFilter::QMqttTopicFilter(const QString &filter = QString())

Crea un nuevo filtro de temas MQTT con el filter especificado.

QMqttTopicFilter::QMqttTopicFilter(const QMqttTopicFilter &filter)

Crea un nuevo filtro de temas MQTT como copia de filter.

[noexcept] QMqttTopicFilter::~QMqttTopicFilter()

Elimina el objeto « QMqttTopicFilter ».

QString QMqttTopicFilter::filter() const

Devuelve el filtro de temas.

Véase también setFilter().

bool QMqttTopicFilter::isValid() const

Devuelve « true » si el filtro de tema es válido según la sección 4.7 del estándar MQTT, o « false » en caso contrario.

bool QMqttTopicFilter::match(const QMqttTopicName &name, QMqttTopicFilter::MatchOptions matchOptions = NoMatchOption) const

Devuelve « true » si el filtro de tema coincide con el nombre del tema « name », respetando el valor proporcionado « matchOptions », o « false » en caso contrario.

void QMqttTopicFilter::setFilter(const QString &filter)

Establece el filtro de temas en « filter ».

Véase también filter().

QString QMqttTopicFilter::sharedSubscriptionName() const

Devuelve el nombre de un recurso compartido si el filtro de temas se ha especificado como una suscripción compartida. El formato de las suscripciones compartidas se define como « $share/sharename/topicfilter ».

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

Sustituye el filtro de temas MQTT « other » por este filtro de temas MQTT. Esta operación es muy rápida y nunca falla.

QMqttTopicFilter &QMqttTopicFilter::operator=(const QMqttTopicFilter &filter)

Asigna el filtro de tema MQTT « filter » a este objeto y devuelve una referencia a la copia.

Elementos no miembros relacionados

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

Devuelve « true » si los filtros de tema « lhs » y « rhs » son diferentes; en caso contrario, devuelve « false ».

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

Devuelve « true » si el filtro de tema lhs es léxicamente menor que el filtro de tema rhs; en caso contrario, devuelve « false ».

QDataStream &operator<<(QDataStream &out, const QMqttTopicFilter &filter)

Escribe el filtro de temas filter en el flujo out y devuelve una referencia al flujo.

Véase también el formato de los operadores de QDataStream.

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

Devuelve « true » si los filtros de tema « lhs » y « rhs » son iguales; en caso contrario, devuelve « false ».

QDataStream &operator>>(QDataStream &in, QMqttTopicFilter &filter)

Lee un filtro de temas en un objeto ` filter ` a partir del flujo ` in ` y devuelve una referencia al flujo.

Véase también el formato de los operadores de QDataStream.

© 2026 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.