QXmlStreamAttributes Class
La classe QXmlStreamAttributes représente un vecteur de QXmlStreamAttribute. Plus....
| En-tête : | #include <QXmlStreamAttributes> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Core)target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake : | QT += core |
| Héritages : | QList |
- Liste de tous les membres, y compris les membres hérités
- QXmlStreamAttributes fait partie des classes XML.
Note : Toutes les fonctions de cette classe sont réentrantes.
Fonctions publiques
| QXmlStreamAttributes() | |
| void | append(const QString &namespaceUri, const QString &name, const QString &value) |
| void | append(const QString &qualifiedName, const QString &value) |
| bool | hasAttribute(QAnyStringView qualifiedName) const |
| bool | hasAttribute(QAnyStringView namespaceUri, QAnyStringView name) const |
| QStringView | value(QAnyStringView namespaceUri, QAnyStringView name) const |
| QStringView | value(QAnyStringView qualifiedName) const |
Description détaillée
Les attributs sont renvoyés par un QXmlStreamReader dans attributes() lorsque le lecteur signale un start element. La classe peut également être utilisée avec un QXmlStreamWriter en tant qu'argument de writeAttributes().
La fonction de commodité value() parcourt le vecteur et renvoie une valeur d'attribut pour un namespaceUri donné et un nom d'attribut.
De nouveaux attributs peuvent être ajoutés avec append().
Documentation des fonctions membres
QXmlStreamAttributes::QXmlStreamAttributes()
Un constructeur pour QXmlStreamAttributes.
void QXmlStreamAttributes::append(const QString &namespaceUri, const QString &name, const QString &value)
Ajoute un nouvel attribut avec name dans l'espace de noms décrit avec namespaceUri, et la valeur value. L'adresse namespaceUri peut être vide.
void QXmlStreamAttributes::append(const QString &qualifiedName, const QString &value)
Ajoute un nouvel attribut avec le nom qualifié qualifiedName et la valeur value.
Il s'agit d'une fonction surchargée.
bool QXmlStreamAttributes::hasAttribute(QAnyStringView qualifiedName) const
Renvoie true si ce QXmlStreamAttributes a un attribut dont le nom qualifié est qualifiedName; sinon, renvoie false.
Notez que cette méthode ne tient pas compte de l'espace de noms. Par exemple, si QXmlStreamAttributes contient un attribut dont le nom lexical est "xlink:href", cela ne signifie pas qu'un attribut nommé href dans l'espace de noms XLink est présent, puisque le préfixe xlink peut être lié à n'importe quel espace de noms. Utilisez la surcharge qui prend en paramètre un URI d'espace de noms et un nom local, pour un code prenant en compte l'espace de noms.
bool QXmlStreamAttributes::hasAttribute(QAnyStringView namespaceUri, QAnyStringView name) const
Renvoie true si ce QXmlStreamAttributes possède un attribut dont l'URI de l'espace de noms et le nom correspondent à namespaceUri et name; sinon, renvoie false.
Il s'agit d'une fonction surchargée.
[noexcept] QStringView QXmlStreamAttributes::value(QAnyStringView namespaceUri, QAnyStringView name) const
Renvoie la valeur de l'attribut name dans l'espace de noms décrit par namespaceUri, ou une chaîne de référence vide si l'attribut n'est pas défini. L'adresse namespaceUri peut être vide.
Remarque : dans les versions de Qt XML antérieures à la version 6.6, cette fonction était implémentée en tant qu'ensemble de surcharge acceptant uniquement les combinaisons de QString et QLatin1StringView.
[noexcept] QStringView QXmlStreamAttributes::value(QAnyStringView qualifiedName) const
Renvoie la valeur de l'attribut dont le nom qualifié est qualifiedName, ou une chaîne de référence vide si l'attribut n'est pas défini. Un nom qualifié est le nom brut d'un attribut dans les données XML. Il se compose du préfixe de l'espace de noms, suivi de deux points, puis du nom local de l'attribut. Étant donné que le préfixe de l'espace de noms n'est pas unique (le même préfixe peut pointer vers différents espaces de noms et différents préfixes peuvent pointer vers le même espace de noms), vous ne devriez pas utiliser de noms qualifiés, mais un namespaceUri résolu et le nom local de l'attribut.
Remarque : dans les versions de Qt XML antérieures à la version 6.6, cette fonction était implémentée en tant qu'ensemble de surcharge acceptant uniquement QString et QLatin1StringView.
Il s'agit d'une fonction surchargée.
© 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.
