Obsolete Members for QDomDocument

Les membres suivants de la classe QDomDocument sont obsolètes. Ils sont fournis pour permettre aux anciens codes sources de continuer à fonctionner. Il est fortement déconseillé de les utiliser dans un nouveau code.

Fonctions publiques

Documentation des fonctions membres

[deprecated in 6.8] bool QDomDocument::setContent(QIODevice *dev, QString *errorMsg, int *errorLine = nullptr, int *errorColumn = nullptr)

Cette fonction est obsolète depuis la version 6.8. Il est fortement déconseillé de l'utiliser dans un nouveau code.

Utilisez plutôt la surcharge renvoyant ParseResult.

Cette fonction lit le document XML à partir du périphérique IO dev, renvoyant true si le contenu a été analysé avec succès ; sinon, elle renvoie false.

Aucun traitement de l'espace de noms n'est effectué.

[deprecated in 6.8] bool QDomDocument::setContent(const QByteArray &buffer, QString *errorMsg, int *errorLine = nullptr, int *errorColumn = nullptr)

Cette fonction est obsolète depuis la version 6.8. Il est fortement déconseillé de l'utiliser dans un nouveau code.

Utilisez plutôt la surcharge renvoyant ParseResult.

Cette fonction lit le document XML à partir du tableau d'octets buffer, en renvoyant true si le contenu a été analysé avec succès ; sinon, elle renvoie false.

Aucun traitement de l'espace de noms n'est effectué.

[deprecated in 6.8] bool QDomDocument::setContent(const QString &text, QString *errorMsg, int *errorLine = nullptr, int *errorColumn = nullptr)

Cette fonction est obsolète depuis la version 6.8. Il est fortement déconseillé de l'utiliser dans un nouveau code.

Utilisez plutôt la surcharge renvoyant ParseResult.

Cette fonction lit le document XML à partir de la chaîne text, en renvoyant true si le contenu a été analysé avec succès ; sinon, elle renvoie false. Comme text est déjà une chaîne Unicode, aucune détection d'encodage n'est effectuée.

Aucun traitement de l'espace de noms n'est effectué non plus.

[deprecated in 6.8] bool QDomDocument::setContent(QIODevice *dev, bool namespaceProcessing, QString *errorMsg = nullptr, int *errorLine = nullptr, int *errorColumn = nullptr)

Cette fonction est obsolète depuis la version 6.8. Il est fortement déconseillé de l'utiliser dans un nouveau code.

Utilisez plutôt la surcharge prenant ParseOptions.

Cette fonction lit le document XML à partir du périphérique IO dev, en renvoyant true si le contenu a été analysé avec succès ; sinon, elle renvoie false.

[deprecated in 6.8] bool QDomDocument::setContent(QXmlStreamReader *reader, bool namespaceProcessing, QString *errorMsg = nullptr, int *errorLine = nullptr, int *errorColumn = nullptr)

Cette fonction est obsolète depuis la version 6.8. Il est fortement déconseillé de l'utiliser dans un nouveau code.

Utilisez plutôt la surcharge prenant ParseOptions.

Cette fonction lit le document XML à partir de QXmlStreamReader reader et l'analyse. Elle renvoie true si le contenu a été analysé avec succès, sinon elle renvoie false.

Si namespaceProcessing est true, l'analyseur reconnaît les espaces de noms dans le fichier XML et définit le nom du préfixe, le nom local et l'URI de l'espace de noms avec les valeurs appropriées. Si namespaceProcessing est false, l'analyseur ne traite pas les espaces de noms lorsqu'il lit le fichier XML.

En cas d'erreur d'analyse, le message d'erreur est placé dans *errorMsg , le numéro de ligne dans *errorLine et le numéro de colonne dans *errorColumn (sauf si le pointeur associé est défini sur nullptr).

Voir aussi QXmlStreamReader.

[deprecated in 6.8] bool QDomDocument::setContent(const QByteArray &data, bool namespaceProcessing, QString *errorMsg = nullptr, int *errorLine = nullptr, int *errorColumn = nullptr)

Cette fonction est obsolète depuis la version 6.8. Il est fortement déconseillé de l'utiliser dans un nouveau code.

Utilisez plutôt la surcharge prenant ParseOptions.

Cette fonction analyse le document XML à partir du tableau d'octets data et le définit comme le contenu du document. Elle tente de détecter l'encodage du document comme l'exige la spécification XML.

Si namespaceProcessing est vrai, l'analyseur reconnaît les espaces de noms dans le fichier XML et définit le nom du préfixe, le nom local et l'URI de l'espace de noms avec les valeurs appropriées. Si namespaceProcessing est faux, l'analyseur ne traite pas les espaces de noms lorsqu'il lit le fichier XML.

En cas d'erreur d'analyse, cette fonction renvoie false et le message d'erreur est placé dans *errorMsg , le numéro de ligne dans *errorLine et le numéro de colonne dans *errorColumn (à moins que le pointeur associé ne soit défini sur nullptr) ; sinon, cette fonction renvoie true.

Si namespaceProcessing est vrai, la fonction QDomNode::prefix() renvoie une chaîne pour tous les éléments et attributs. Elle renvoie 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.

Si namespaceProcessing est faux, les fonctions QDomNode::prefix(), QDomNode::localName() et QDomNode::namespaceURI() renvoient une chaîne vide.

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ère apparaissant 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.

Voir aussi QDomNode::namespaceURI(), QDomNode::localName(), QDomNode::prefix(), QString::isNull() et QString::isEmpty().

[deprecated in 6.8] bool QDomDocument::setContent(const QString &text, bool namespaceProcessing, QString *errorMsg = nullptr, int *errorLine = nullptr, int *errorColumn = nullptr)

Cette fonction est obsolète depuis la version 6.8. Il est fortement déconseillé de l'utiliser dans un nouveau code.

Utilisez plutôt les surcharges prenant ParseOptions.

Cette fonction lit le document XML à partir de la chaîne text, en renvoyant true si le contenu a été analysé avec succès ; sinon, elle renvoie false. Comme text est déjà une chaîne Unicode, aucune détection d'encodage n'est effectuée.