QXmlStreamAttributes Class
La classe `QXmlStreamAttributes` représente un vecteur d'QXmlStreamAttribute. En savoir plus...
| En-tête : | #include <QXmlStreamAttributes> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake : | QT += core |
| Hérite de : | QList |
- Liste de tous les membres, y compris les membres hérités
- QXmlStreamAttributes fait partie des classes XML.
Remarque : 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 objet ` QXmlStreamReader ` dans la méthode ` attributes()` lorsque le lecteur signale une erreur de type ` start element`. La classe peut également être utilisée avec un objet ` QXmlStreamWriter ` en tant qu’argument de la méthode ` writeAttributes()`.
La fonction de commodité value() parcourt le vecteur et renvoie la valeur d’un attribut pour un namespaceUri et un nom d’attribut donnés.
De nouveaux attributs peuvent être ajoutés à l'aide de 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 l'name, dans l'espace de noms décrit par namespaceUri, et la valeur value. L'namespaceUri peut être vide.
void QXmlStreamAttributes::append(const QString &qualifiedName, const QString &value)
Ajoute un nouvel attribut dont le nom qualifié est « qualifiedName » et la valeur « value ».
Il s'agit d'une fonction surchargée.
bool QXmlStreamAttributes::hasAttribute(QAnyStringView qualifiedName) const
Renvoie « true » si cet objet « QXmlStreamAttributes » possède un attribut dont le nom qualifié est « qualifiedName » ; sinon, renvoie « false ».
Notez que cette fonction ne tient pas compte des espaces de noms. Par exemple, si cet QXmlStreamAttributes contient un attribut dont le nom lexical est « xlink:href », cela n’indique pas qu’un attribut nommé href dans l’espace de noms XLink est présent, car le préfixe xlink peut être lié à n’importe quel espace de noms. Utilisez la surcharge qui prend un URI d’espace de noms et un nom local en paramètre, pour un code tenant compte des espaces de noms.
bool QXmlStreamAttributes::hasAttribute(QAnyStringView namespaceUri, QAnyStringView name) const
Renvoie true si cette QXmlStreamAttributes possède un attribut dont l'URI d'espace de noms et le nom correspondent respectivement à 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 référence à une chaîne vide si l'attribut n'est pas défini. L'namespaceUri peut être vide.
Remarque : dans les versions de Qt antérieures à la version 6.6, cette fonction était implémentée sous la forme d’un ensemble de surcharges n’acceptant que des 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 référence à une chaîne vide si l'attribut n'est pas défini. Un nom qualifié correspond au nom brut d'un attribut dans les données XML. Il se compose du préfixe de l'espace de noms, suivi d'un deux-points, puis du nom local de l'attribut. Étant donné que le préfixe d'espace de noms n'est pas unique (un même préfixe peut désigner différents espaces de noms et différents préfixes peuvent désigner le même espace de noms), vous ne devez pas utiliser de noms qualifiés, mais un `namespaceUri` résolu et le nom local de l'attribut.
Remarque : dans les versions de Qt antérieures à la version 6.6, cette fonction était implémentée sous la forme d’un ensemble de surcharges n’acceptant que des ` QString ` et des ` 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.
