Obsolete Members for QDomDocument

Les membres suivants de la classe ` QDomDocument ` sont obsolètes. Ils sont fournis afin de garantir la compatibilité avec l'ancien code source. Nous déconseillons fortement de les utiliser dans du 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. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Utilisez plutôt la surcharge renvoyant un ` ParseResult `.

Cette fonction lit le document XML à partir du périphérique d'E/S dev et renvoie true si le contenu a été analysé avec succès ; dans le cas contraire, elle renvoie false.

Aucun traitement des espaces 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. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Utilisez plutôt la surcharge renvoyant un ` ParseResult `.

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

Aucun traitement des espaces 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. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Utilisez plutôt la surcharge renvoyant ` ParseResult `.

Cette fonction lit le document XML à partir de la chaîne text et renvoie 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 des espaces 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. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Utilisez plutôt la surcharge prenant en paramètre ParseOptions.

Cette fonction lit le document XML à partir du périphérique d'E/S dev et renvoie 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. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Utilisez plutôt la surcharge prenant en paramètre 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 attribue les valeurs appropriées au nom de préfixe, au nom local et à l’URI de l’espace de noms. Si namespaceProcessing est false, l’analyseur n’effectue aucun traitement des espaces de noms lors de la lecture du 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 (à moins que le pointeur associé ne soit défini sur nullptr).

Voir également 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. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Utilisez plutôt la surcharge prenant en paramètre un tableau d'ParseOptions.

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

Si namespaceProcessing est vrai, l’analyseur reconnaît les espaces de noms dans le fichier XML et attribue les valeurs appropriées au nom du préfixe, au nom local et à l’URI de l’espace de noms. Si namespaceProcessing est faux, l’analyseur n’effectue aucun traitement des espaces de noms lors de la lecture du fichier XML.

Si une erreur d’analyse se produit, 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 de caractères 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 composés uniquement d’espaces sont supprimés et n’apparaîtront pas dans l’ QDomDocument.

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

Les références d’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 » dans lequel les références sont remplacées par leurs valeurs d’entité correspondantes.
• Les références aux entités paramétriques présentes dans le sous-ensemble interne sont incluses. Le résultat est un nœud ` QDomDocumentType ` contenant les déclarations d’entités et de notation, les références étant remplacées par leurs valeurs d’entité correspondantes.
• Toute référence à une 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 sous la forme d’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 également 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. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Utilisez plutôt les surcharges prenant en paramètre une chaîne de caractères de type ` ParseOptions `.

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