QDomDocument Class

QDomDocument doc("mydocument");
QFile file("mydocument.xml");
if (!file.open(QIODevice::ReadOnly))
    return;
if (!doc.setContent(&file)) {
    file.close();
    return;
}
file.close();

// print out the element names of all elements that are direct children
// of the outermost element.
QDomElement docElem = doc.documentElement();

QDomNode n = docElem.firstChild();
while(!n.isNull()) {
    QDomElement e = n.toElement(); // try to convert the node to an element.
    if(!e.isNull()) {
        cout << qPrintable(e.tagName()) << '\n'; // the node really is an element.
    }
    n = n.nextSibling();
}

// Here we append a new element to the end of the document
QDomElement elem = doc.createElement("img");
elem.setAttribute("src", "myimage.png");
docElem.appendChild(elem);

QDomDocument doc;
QDomElement root = doc.createElement("MyML");
doc.appendChild(root);

QDomElement tag = doc.createElement("Greeting");
root.appendChild(tag);

QDomText t = doc.createTextNode("Hello World");
tag.appendChild(t);

QString xml = doc.toString();

Documentation des fonctions membres

QDomDocument::QDomDocument()

Construit un document vide.

[explicit] QDomDocument::QDomDocument(const QDomDocumentType &doctype)

Crée un document de type doctype.

Voir aussi QDomImplementation::createDocumentType().

[explicit] QDomDocument::QDomDocument(const QString &name)

Crée un document et définit le nom du type de document à name.

QDomDocument::QDomDocument(const QDomDocument &document)

Construit une copie de document.

Les données de la copie sont partagées (copie superficielle) : modifier un noeud modifiera également l'autre. Si vous voulez faire une copie profonde, utilisez cloneNode().

[noexcept] QDomDocument::~QDomDocument()

Détruit l'objet et libère ses ressources.

QDomAttr QDomDocument::createAttribute(const QString &name)

Crée un nouvel attribut appelé name qui peut être inséré dans un élément, par exemple à l'aide de QDomElement::setAttributeNode().

Si name n'est pas un nom XML valide, le comportement de cette fonction est régi par QDomImplementation::InvalidDataPolicy.

Voir aussi createAttributeNS().

QDomAttr QDomDocument::createAttributeNS(const QString &nsURI, const QString &qName)

Crée un nouvel attribut avec prise en charge de l'espace de noms qui peut être inséré dans un élément. Le nom de l'attribut est qName et l'URI de l'espace de noms est nsURI. Cette fonction définit également QDomNode::prefix() et QDomNode::localName() aux valeurs appropriées (en fonction de qName).

Si qName n'est pas un nom XML valide, le comportement de cette fonction est régi par QDomImplementation::InvalidDataPolicy.

Voir aussi createAttribute().

QDomCDATASection QDomDocument::createCDATASection(const QString &value)

Crée une nouvelle section CDATA pour la chaîne value qui peut être insérée dans le document, par exemple à l'aide de QDomNode::appendChild().

Si value contient des caractères qui ne peuvent pas être stockés dans une section CDATA, le comportement de cette fonction est régi par QDomImplementation::InvalidDataPolicy.

Voir également QDomNode::appendChild(), QDomNode::insertBefore() et QDomNode::insertAfter().

QDomComment QDomDocument::createComment(const QString &value)

Crée un nouveau commentaire pour la chaîne value qui peut être inséré dans le document, par exemple à l'aide de QDomNode::appendChild().

Si value contient des caractères qui ne peuvent pas être stockés dans un commentaire XML, le comportement de cette fonction est régi par QDomImplementation::InvalidDataPolicy.

Voir également QDomNode::appendChild(), QDomNode::insertBefore() et QDomNode::insertAfter().

QDomDocumentFragment QDomDocument::createDocumentFragment()

Crée un nouveau fragment de document, qui peut être utilisé pour contenir des parties du document, par exemple lors de manipulations complexes de l'arborescence du document.

QDomElement QDomDocument::createElement(const QString &tagName)

Crée un nouvel élément appelé tagName qui peut être inséré dans l'arbre DOM, par exemple en utilisant QDomNode::appendChild().

Si tagName n'est pas un nom XML valide, le comportement de cette fonction est régi par QDomImplementation::InvalidDataPolicy.

Voir aussi createElementNS(), QDomNode::appendChild(), QDomNode::insertBefore(), et QDomNode::insertAfter().

QDomElement QDomDocument::createElementNS(const QString &nsURI, const QString &qName)

Crée un nouvel élément avec prise en charge de l'espace de noms qui peut être inséré dans l'arbre DOM. Le nom de l'élément est qName et l'URI de l'espace de noms est nsURI. Cette fonction définit également QDomNode::prefix() et QDomNode::localName() aux valeurs appropriées (en fonction de qName).

Si qName est une chaîne vide, elle renvoie un élément nul, que la politique relative aux données non valides soit définie ou non.

Voir également createElement().

QDomEntityReference QDomDocument::createEntityReference(const QString &name)

Crée une nouvelle référence d'entité appelée name qui peut être insérée dans le document, par exemple à l'aide de QDomNode::appendChild().

Si name n'est pas un nom XML valide, le comportement de cette fonction est régi par QDomImplementation::InvalidDataPolicy.

Voir également QDomNode::appendChild(), QDomNode::insertBefore() et QDomNode::insertAfter().

QDomProcessingInstruction QDomDocument::createProcessingInstruction(const QString &target, const QString &data)

Crée une nouvelle instruction de traitement qui peut être insérée dans le document, par exemple à l'aide de QDomNode::appendChild(). Cette fonction définit la cible de l'instruction de traitement à target et les données à data.

Si target n'est pas un nom XML valide, ou si les données contiennent des caractères qui ne peuvent pas apparaître dans une instruction de traitement, le comportement de cette fonction est régi par QDomImplementation::InvalidDataPolicy.

Voir également QDomNode::appendChild(), QDomNode::insertBefore() et QDomNode::insertAfter().

QDomText QDomDocument::createTextNode(const QString &value)

Crée un nœud de texte pour la chaîne value qui peut être inséré dans l'arbre du document, par exemple en utilisant QDomNode::appendChild().

Si value contient des caractères qui ne peuvent pas être stockés en tant que données de caractères d'un document XML (même sous la forme de références de caractères), le comportement de cette fonction est régi par QDomImplementation::InvalidDataPolicy.

Voir également QDomNode::appendChild(), QDomNode::insertBefore() et QDomNode::insertAfter().

QDomDocumentType QDomDocument::doctype() const

Renvoie le type de document de ce document.

QDomElement QDomDocument::documentElement() const

Renvoie l'élément racine du document.

QDomElement QDomDocument::elementById(const QString &elementId)

Renvoie l'élément dont l'ID est égal à elementId. Si aucun élément avec l'ID n'a été trouvé, cette fonction renvoie un null element.

Étant donné que les QDomClasses ne savent pas quels attributs sont des ID d'éléments, cette fonction renvoie toujours null element. Cela pourrait changer dans une version future.

QDomNodeList QDomDocument::elementsByTagName(const QString &tagname) const

Renvoie un fichier QDomNodeList, qui contient tous les éléments du document portant le nom tagname. L'ordre de la liste des nœuds est l'ordre dans lequel ils sont rencontrés lors d'un parcours préalable de l'arbre des éléments.

Voir aussi elementsByTagNameNS() et QDomElement::elementsByTagName().

QDomNodeList QDomDocument::elementsByTagNameNS(const QString &nsURI, const QString &localName)

Renvoie un fichier QDomNodeList contenant tous les éléments du document dont le nom local est localName et l'URI de l'espace de noms nsURI. L'ordre de la liste des nœuds est l'ordre dans lequel ils sont rencontrés lors d'un parcours préalable de l'arbre des éléments.

Voir également elementsByTagName() et QDomElement::elementsByTagNameNS().

QDomImplementation QDomDocument::implementation() const

Renvoie un objet QDomImplementation.

QDomNode QDomDocument::importNode(const QDomNode &importedNode, bool deep)

Importe le noeud importedNode d'un autre document vers ce document. importedNode reste dans le document original ; cette fonction crée une copie qui peut être utilisée dans ce document.

Cette fonction renvoie le nœud importé qui appartient à ce document. Le nœud retourné n'a pas de parent. Il n'est pas possible d'importer les nœuds QDomDocument et QDomDocumentType. Dans ce cas, cette fonction renvoie un null node.

Si importedNode est un null node, un nœud nul est renvoyé.

Si deep est vrai, cette fonction importe non seulement le nœud importedNode mais aussi tout son sous-arbre ; s'il est faux, seul le nœud importedNode est importé. L'argument deep n'a aucun effet sur les nœuds QDomAttr et QDomEntityReference, puisque les descendants des nœuds QDomAttr sont toujours importés et ceux des nœuds QDomEntityReference ne le sont jamais.

Le comportement de cette fonction est légèrement différent selon les types de nœuds :

Voir aussi QDomElement::setAttribute(), QDomNode::insertBefore(), QDomNode::insertAfter(), QDomNode::replaceChild(), QDomNode::removeChild(), et QDomNode::appendChild().

QDomNode::NodeType QDomDocument::nodeType() const

Retourne DocumentNode.

Cette fonction analyse le document XML à partir du tableau d'octets data, de la vue de chaîne text, de l'IO device, ou du flux reader et le définit comme le contenu du document. Elle tente de détecter le codage du document, conformément à la spécification XML. Renvoie le résultat de l'analyse dans ParseResult, qui convertit explicitement en bool.

Vous pouvez utiliser le paramètre options pour spécifier différentes options d'analyse, par exemple pour activer le traitement des espaces de noms, etc.

Par défaut, le traitement des espaces de noms est désactivé. S'il est désactivé, l'analyseur ne traite pas les espaces de noms lorsqu'il lit le fichier XML. Les fonctions QDomNode::prefix(), QDomNode::localName() et QDomNode::namespaceURI() renvoient une chaîne vide.

Si le traitement des espaces de noms est activé via l'analyseur options, l'analyseur reconnaît les espaces de noms dans le fichier XML et donne au nom du préfixe, au nom local et à l'URI de l'espace de noms les valeurs appropriées. Les fonctions QDomNode::prefix(), QDomNode::localName() et QDomNode::namespaceURI() renvoient une chaîne pour tous les éléments et attributs et renvoient une chaîne vide si l'élément ou l'attribut n'a pas de préfixe.

Les nœuds de texte constitués uniquement d'espaces blancs sont supprimés et n'apparaissent pas dans le fichier QDomDocument. Depuis Qt 6.5, il est possible de passer QDomDocument::ParseOption::PreserveSpacingOnlyNodes comme option d'analyse, pour spécifier que les nœuds de texte constitués uniquement d'espaces doivent être préservés.

Les références à des entités sont traitées comme suit :

• Les références aux entités générales internes et aux entités de caractères présentes dans le contenu sont incluses. Le résultat est un nœud QDomText dont les références sont remplacées par les valeurs d'entité correspondantes.
• Les références aux entités de paramètres présentes dans le sous-ensemble interne sont incluses. Le résultat est un nœud QDomDocumentType qui contient des déclarations d'entité et de notation avec les références remplacées par leurs valeurs d'entité correspondantes.
• Toute référence d'entité analysée générale qui n'est pas définie dans le sous-ensemble interne et qui apparaît dans le contenu est représentée par un nœud QDomEntityReference.
• Toute référence d'entité analysée qui n'est pas définie dans le sous-ensemble interne et qui apparaît en dehors du contenu est remplacée par une chaîne vide.
• Toute référence d'entité non analysée est remplacée par une chaîne vide.

Ces fonctions ont été introduites dans Qt 6.5.

Voir également ParseResult et ParseOptions.

QByteArray QDomDocument::toByteArray(int indent = 1) const

Convertit le document analysé en sa représentation textuelle et renvoie une adresse QByteArray contenant les données encodées en UTF-8.

Cette fonction utilise indent comme espace d'indentation des sous-éléments.

Voir aussi toString().

QString QDomDocument::toString(int indent = 1) const

Convertit le document analysé en sa représentation textuelle.

Cette fonction utilise indent comme espace pour indenter les sous-éléments.

Si indent vaut -1, aucun espace n'est ajouté.

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

Assigne other à ce document DOM.

Les données de la copie sont partagées (copie superficielle) : modifier un nœud modifiera également l'autre. Si vous voulez faire une copie profonde, utilisez cloneNode().