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 |
- Lista de todos los miembros, incluidos los heredados
- QMqttTopicFilter forma parte de las clases compartidas implícitamente.
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) |
Elementos no miembros relacionados
| 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.
| Constante | Valor | Descripción |
|---|---|---|
QMqttTopicFilter::NoMatchOption | 0x0000 | No hay opciones de coincidencia configuradas. |
QMqttTopicFilter::WildcardsDontMatchDollarTopicMatchOption | 0x0001 | Un 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.