En esta página

QXmlNamespaceSupport Class

La clase QXmlNamespaceSupport es una clase auxiliar para lectores de XML que deseen incorporar compatibilidad con los espacios de nombres. Más información...

Encabezado: #include <QXmlNamespaceSupport>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core5Compat)
target_link_libraries(mytarget PRIVATE Qt6::Core5Compat)
qmake: QT += core5compat

Nota: Todas las funciones de esta clase son reentrantes.

Funciones públicas

QXmlNamespaceSupport()
~QXmlNamespaceSupport()
void popContext()
QString prefix(const QString &uri) const
QStringList prefixes() const
QStringList prefixes(const QString &uri) const
void processName(const QString &qname, bool isAttribute, QString &nsuri, QString &localname) const
void pushContext()
void reset()
void setPrefix(const QString &pre, const QString &uri)
void splitName(const QString &qname, QString &prefix, QString &localname) const
QString uri(const QString &prefix) const

Descripción detallada

Se puede establecer el prefijo del espacio de nombres actual con ` setPrefix()` y obtener la lista de prefijos actuales (o los correspondientes a un URI determinado) con ` prefixes()`. El URI del espacio de nombres está disponible mediante ` uri()`. Utilice ` pushContext()` para iniciar un nuevo contexto de espacio de nombres y ` popContext()` para volver al contexto de espacio de nombres anterior. Utilice splitName() o processName() para dividir un nombre en su prefijo y su nombre local.

Documentación de las funciones miembro

QXmlNamespaceSupport::QXmlNamespaceSupport()

Crea un objeto QXmlNamespaceSupport.

[noexcept] QXmlNamespaceSupport::~QXmlNamespaceSupport()

Destruye un « QXmlNamespaceSupport ».

void QXmlNamespaceSupport::popContext()

Vuelve al contexto de espacio de nombres anterior.

Normalmente, debes eliminar el contexto al final de cada elemento XML. Tras eliminar el contexto, se restablecen todas las asignaciones de prefijos de espacio de nombres que estaban vigentes anteriormente.

Véase también pushContext().

QString QXmlNamespaceSupport::prefix(const QString &uri) const

Devuelve uno de los prefijos asociados al URI del espacio de nombres uri.

Si actualmente hay más de un prefijo asignado al mismo URI, esta función realiza una selección arbitraria; si deseas obtener todos los prefijos, utiliza en su lugar prefixes().

Nota: para comprobar si existe un prefijo por defecto, utiliza la función uri() con el argumento «».

Véase también setPrefix().

QStringList QXmlNamespaceSupport::prefixes() const

Devuelve una lista de todos los prefijos declarados actualmente.

Si existe un prefijo por defecto, esta función no lo incluye en la lista; para comprobar cuál es el prefijo por defecto, utiliza la función ` uri()` con el argumento «».

QStringList QXmlNamespaceSupport::prefixes(const QString &uri) const

Devuelve una lista de todos los prefijos declarados actualmente para el URI del espacio de nombres uri.

Se incluye el prefijo «xml:». Si solo quieres un prefijo asignado a la URI del espacio de nombres y no te importa cuál sea, utiliza en su lugar la función prefix().

Nota: El prefijo vacío (por defecto) nunca se incluye en esta lista; para comprobar la presencia de un espacio de nombres por defecto, llama a uri() con "" como argumento.

Esta es una función sobrecargada.

void QXmlNamespaceSupport::processName(const QString &qname, bool isAttribute, QString &nsuri, QString &localname) const

Procesa un nombre XML 1.0 sin formato en el contexto actual eliminando el prefijo y buscándolo entre los prefijos declarados actualmente.

qname es el nombre XML 1.0 sin formato que se va a procesar. isAttribute es verdadero si el nombre es un nombre de atributo.

Esta función almacena el URI del espacio de nombres en ` nsuri ` (que se establecerá en una cadena vacía si el nombre sin formato tiene un prefijo no declarado) y almacena el nombre local (sin prefijo) en ` localname ` (que se establecerá en una cadena vacía si no se está utilizando ningún espacio de nombres).

Tenga en cuenta que los nombres de atributos se procesan de forma diferente a los nombres de elementos: un nombre de elemento sin prefijo recibe el espacio de nombres por defecto (si lo hay), mientras que un nombre de atributo sin prefijo no lo recibe.

void QXmlNamespaceSupport::pushContext()

Inicia un nuevo contexto de espacio de nombres.

Normalmente, se debe insertar un nuevo contexto al principio de cada elemento XML: el nuevo contexto hereda automáticamente las declaraciones de su contexto padre y, además, lleva un registro de las declaraciones realizadas dentro de este contexto.

Véase también popContext().

void QXmlNamespaceSupport::reset()

Restablece este objeto de soporte del espacio de nombres para que quede listo para su reutilización.

void QXmlNamespaceSupport::setPrefix(const QString &pre, const QString &uri)

Esta función declara que el prefijo pre, en el contexto del espacio de nombres actual, corresponde al URI del espacio de nombres uri. El prefijo permanece vigente hasta que se elimine este contexto, a menos que quede oculto en un contexto descendiente.

Ten en cuenta que existe una asimetría en esta biblioteca. La función ` prefix()` no devuelve el prefijo predeterminado «», aunque hayas declarado uno; para comprobar si existe un prefijo predeterminado, debes buscarlo explícitamente mediante ` uri()`. Esta asimetría existe para facilitar la búsqueda de prefijos para nombres de atributos, donde no se permite el prefijo predeterminado.

Véase también prefix().

void QXmlNamespaceSupport::splitName(const QString &qname, QString &prefix, QString &localname) const

Divide el nombre qname por el carácter «:» y devuelve el prefijo en prefix y el nombre local en localname.

Véase también processName().

QString QXmlNamespaceSupport::uri(const QString &prefix) const

Busca el prefijo prefix en el contexto actual y devuelve la URI del espacio de nombres asignado actualmente. Utiliza la cadena vacía («») para el espacio de nombres por defecto.

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