En esta página

QNdefFilter Class

La clase QNdefFilter proporciona un filtro para la coincidencia de mensajes NDEF. Más información...

Encabezado: #include <QNdefFilter>
CMake: find_package(Qt6 REQUIRED COMPONENTS Nfc)
target_link_libraries(mytarget PRIVATE Qt6::Nfc)
qmake: QT += nfc

Tipos públicos

struct Record

Funciones públicas

QNdefFilter()
QNdefFilter(const QNdefFilter &other)
~QNdefFilter()
bool appendRecord(const QNdefFilter::Record &record)
bool appendRecord(unsigned int min = 1, unsigned int max = 1)
bool appendRecord(QNdefRecord::TypeNameFormat typeNameFormat, const QByteArray &type, unsigned int min = 1, unsigned int max = 1)
void clear()
(since 6.2) bool match(const QNdefMessage &message) const
bool orderMatch() const
QNdefFilter::Record recordAt(qsizetype i) const
qsizetype recordCount() const
void setOrderMatch(bool on)
QNdefFilter &operator=(const QNdefFilter &other)

Descripción detallada

QNdefFilter encapsula la estructura de un mensaje NDEF y se utiliza para buscar mensajes que tengan una estructura concreta.

El siguiente filtro busca mensajes NDEF que contengan un único registro de póster inteligente:

QNdefFilter filter;
filter.append(QNdefRecord::NfcRtd, "Sp");

El siguiente filtro busca mensajes NDEF que contengan un URI, un fragmento de texto localizado y una imagen JPEG opcional. El orden de los registros debe ser el especificado:

QNdefFilter filter;
filter.setOrderMatch(true);
filter.appendRecord(QNdefRecord::NfcRtd, "U");
filter.appendRecord<QNdefNfcTextRecord>();
filter.appendRecord(QNdefRecord::Mime, "image/jpeg", 0, 1);

El método match() se puede utilizar para comprobar si un mensaje coincide con el filtro.

Algoritmos de coincidencia

El comportamiento del filtro depende del valor del parámetro orderMatch().

Nota: En la explicación que sigue, consideraremos que los registros del filtro son iguales si coinciden sus parámetros ` typeNameFormat ` y ` type `. La unión de dos registros implica sumar sus valores ` minimum ` y ` maximum `, respectivamente.

Coincidencia sin ordenar

Si no se tiene en cuenta el orden de los registros, se pueden unir todos los registros iguales del filtro. El filtro resultante contendrá únicamente registros únicos, cada uno con los valores actualizados de minimum y maximum.

Consideremos el siguiente ejemplo:

QNdefFilter filter;
filter.appendRecord<QNdefNfcTextRecord>(0, 1);
filter.appendRecord<QNdefNfcTextRecord>(0, 1);
filter.appendRecord(QNdefRecord::Mime, "", 1, 1);
filter.appendRecord<QNdefNfcTextRecord>(1, 1);
filter.setOrderMatch(false);

Con la coincidencia sin ordenar, el filtro se simplificará de la siguiente manera:

QNdefFilter filter;
filter.appendRecord<QNdefNfcTextRecord>(1, 3);
filter.appendRecord(QNdefRecord::Mime, "", 1, 1);
filter.setOrderMatch(false);

Una vez que el filtro contiene únicamente los registros únicos, el algoritmo de coincidencia recorre el mensaje y calcula la cantidad real de registros de cada tipo. Si todas las cantidades reales se ajustan a los rangos [mínimo, máximo] correspondientes, el algoritmo de coincidencia devuelve « true ».

Coincidencia ordenada

Si el orden de los registros es importante, se aplica un enfoque diferente. En este caso, los registros iguales no pueden unirse simplemente. Sin embargo, los registros iguales consecutivos sí pueden unirse. A continuación, el algoritmo de coincidencia recorre el mensaje, teniendo en cuenta esta vez también las posiciones de los registros.

Gestión del tipo vacío en el registro de filtro

Es posible añadir un registro de filtro con un « type » vacío. En este caso, el tipo vacío actuará como comodín para cualquier tipo.

Por ejemplo, el filtro puede definirse de la siguiente manera:

QNdefFilter filter;
filter.addRecord(QNdefRecord::Mime, "", 1, 1);

Este filtro especifica que el mensaje debe contener exactamente un registro NDEF con Mime typeNameFormat () y cualquier type().

Gestión de registros adicionales en el mensaje

Si el mensaje contiene algunos registros que no coinciden con ninguno de los del filtro, el algoritmo de coincidencia devolverá false.

Ejemplos de filtros

En la tabla siguiente, cada registro de filtro se especifica mediante los siguientes parámetros (en el orden indicado):

  • typeNameFormat - contiene el typeNameFormat() del registro.
  • type - contiene el valor « type » () del registro.
  • minimum - contiene el número mínimo de apariciones del registro en el mensaje.
  • maximum - contiene el número máximo de apariciones del registro en el mensaje.

El filtro contiene varios registros.

El mensaje consta de varios « QNdefRecord». En la tabla siguiente, solo se mostrarán el « typeNameFormat » () y el « type » () de cada registro, ya que los demás parámetros no son relevantes para el filtrado.

FiltroMensajeResultado de la coincidenciaComentario
Filtro vacíoMensaje vacíoPartido
Vaciar filtroMensaje no vacíoSin coincidencias
Filtro no vacíoMensaje vacíoNo hay coincidencias
[(QNdefRecord::NfcRtd, "T", 1, 2), (QNdefRecord::Mime, "", 1, 1), (QNdefRecord::Empty, "", 0, 100)][(QNdefRecord::Mime, "image/jpeg"), (QNdefRecord::Empty, ""), (QNdefRecord::NfcRtd, "T"), (QNdefRecord::Empty, ""), (QNdefRecord::NfcRtd, "T")]Sin ordenar: coincidenciaEl filtro ordenado no coincide porque el mensaje debe comenzar con un registro « QNdefRecord::NfcRtd », pero comienza con « QNdefRecord::Mime ».
Ordenado: no coincide
[(QNdefRecord::NfcRtd, "T", 0, 2), (QNdefRecord::Mime, "", 1, 1), (QNdefRecord::NfcRtd, "T", 1, 1)][(QNdefRecord::NfcRtd, «T»), (QNdefRecord::NfcRtd, «T»), (QNdefRecord::Mime, «image/jpeg»)]Sin ordenar: coincidenciaEl filtro ordenado no coincide porque se espera un registro QNdefRecord::NfcRtd después de QNdefRecord::Mime, pero el mensaje no lo contiene.
Ordenado: sin coincidencia
[(QNdefRecord::NfcRtd, «T», 0, 2), (QNdefRecord::NfcRtd, «T», 1, 1), (QNdefRecord::Mime, «», 1, 1)][(QNdefRecord::NfcRtd, «T»), (QNdefRecord::Mime, «image/jpeg»)]Sin orden: coincidenciaAmbos casos coinciden porque el mensaje contiene el mínimo requerido de registros en el orden correcto.
Ordenado: coincidencia

Documentación de funciones de miembro

QNdefFilter::QNdefFilter()

Crea un nuevo filtro NDEF.

QNdefFilter::QNdefFilter(const QNdefFilter &other)

Crea un nuevo filtro NDEF que es una copia de other.

[noexcept] QNdefFilter::~QNdefFilter()

Elimina el filtro NDEF.

bool QNdefFilter::appendRecord(const QNdefFilter::Record &record)

Comprueba el record y lo añade al filtro NDEF.

Devuelve « true » si el registro se ha añadido correctamente. En caso contrario, devuelve « false ».

template <typename T> bool QNdefFilter::appendRecord(unsigned int min = 1, unsigned int max = 1)

Añade un registro que coincida con el parámetro de plantilla al filtro NDEF. El registro debe aparecer entre min y max veces en el mensaje NDEF.

Devuelve « true » si el registro se ha añadido correctamente. En caso contrario, devuelve « false ».

bool QNdefFilter::appendRecord(QNdefRecord::TypeNameFormat typeNameFormat, const QByteArray &type, unsigned int min = 1, unsigned int max = 1)

Añade un registro con el formato de nombre de tipo « typeNameFormat » y el tipo « type » al filtro NDEF. El registro debe aparecer entre « min » y « max » veces en el mensaje NDEF.

Devuelve « true » si el registro se ha añadido correctamente. En caso contrario, devuelve « false ».

void QNdefFilter::clear()

Borra el filtro.

[since 6.2] bool QNdefFilter::match(const QNdefMessage &message) const

Devuelve « true » si el « message » coincide con el filtro indicado. En caso contrario, devuelve « false ».

Consulta Matching Algorithms para obtener una explicación más detallada sobre la coincidencia.

Esta función se introdujo en Qt 6.2.

bool QNdefFilter::orderMatch() const

Devuelve « true » si el filtro tiene en cuenta el orden de los registros NDEF a la hora de realizar la coincidencia. En caso contrario, devuelve « false ».

Véase también setOrderMatch().

QNdefFilter::Record QNdefFilter::recordAt(qsizetype i) const

Devuelve el registro NDEF en el índice i.

i Debe ser un índice válido (es decir, 0 <= i < recordCount()).

Véase también recordCount().

qsizetype QNdefFilter::recordCount() const

Devuelve el número de registros NDEF que contiene el filtro.

void QNdefFilter::setOrderMatch(bool on)

Establece los requisitos de ordenación del filtro. Si « on » es « true », el filtro solo coincidirá si el orden de los registros del filtro coincide con el orden de los registros del mensaje NDEF. Si « on » es « false », no se tiene en cuenta el orden de los registros a la hora de establecer la coincidencia.

Por defecto, no se tiene en cuenta el orden de los registros.

Véase también orderMatch().

QNdefFilter &QNdefFilter::operator=(const QNdefFilter &other)

Asigna « other » a este filtro y devuelve una referencia a este filtro.

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