Sur cette page

QDomCharacterData Class

La classe QDomCharacterData représente une chaîne de caractères générique dans le DOM. En savoir plus...

En-tête : #include <QDomCharacterData>
CMake : find_package(Qt6 REQUIRED COMPONENTS Xml)
target_link_libraries(mytarget PRIVATE Qt6::Xml)
qmake : QT += xml
Hérite de : QDomNode
Hérité par :

QDomComment et QDomText

Remarque : toutes les fonctions de cette classe sont réentrantes.

Fonctions publiques

QDomCharacterData()
QDomCharacterData(const QDomCharacterData &characterData)
void appendData(const QString &arg)
QString data() const
void deleteData(unsigned long offset, unsigned long count)
void insertData(unsigned long offset, const QString &arg)
int length() const
QDomNode::NodeType nodeType() const
void replaceData(unsigned long offset, unsigned long count, const QString &arg)
void setData(const QString &data)
QString substringData(unsigned long offset, unsigned long count)
QDomCharacterData &operator=(const QDomCharacterData &other)

Description détaillée

Les données de caractères telles qu’utilisées en XML spécifient une chaîne de données générique. Des versions plus spécialisées de cette classe sont QDomText, QDomComment et QDomCDATASection.

La chaîne de données est définie à l’aide de ` setData()` et récupérée à l’aide de ` data()`. Vous pouvez récupérer une partie de la chaîne de données à l’aide de ` substringData()`. Des données supplémentaires peuvent être ajoutées à la fin à l’aide de ` appendData()` ou insérées à l’aide de ` insertData()`. Des parties de la chaîne de données peuvent être supprimées à l’aide de ` deleteData()` ou remplacées à l’aide de ` replaceData()`. La longueur de la chaîne de données est renvoyée par ` length()`.

Le type de nœud du nœud contenant ces données de caractères est renvoyé par la fonction nodeType().

Voir également QDomText, QDomComment et QDomCDATASection.

Documentation des fonctions membres

QDomCharacterData::QDomCharacterData()

Crée un objet de données de caractères vide.

QDomCharacterData::QDomCharacterData(const QDomCharacterData &characterData)

Crée une copie de ` characterData`.

Les données de la copie sont partagées (copie superficielle) : la modification d'un nœud entraîne également la modification de l'autre. Si vous souhaitez effectuer une copie profonde, utilisez cloneNode().

void QDomCharacterData::appendData(const QString &arg)

Ajoute la chaîne « arg » à la chaîne enregistrée.

QString QDomCharacterData::data() const

Renvoie la chaîne stockée dans cet objet.

Si le nœud est de type ` null node`, la fonction renvoie une chaîne vide.

Voir aussi setData().

void QDomCharacterData::deleteData(unsigned long offset, unsigned long count)

Supprime une sous-chaîne de longueur count à partir de la position offset.

void QDomCharacterData::insertData(unsigned long offset, const QString &arg)

Insère la chaîne « arg » dans la chaîne stockée à la position « offset ».

int QDomCharacterData::length() const

Renvoie la longueur de la chaîne stockée.

QDomNode::NodeType QDomCharacterData::nodeType() const

Renvoie le type de nœud auquel cet objet fait référence (à savoir TextNode, CDATASectionNode, CommentNode ou CharacterDataNode). Pour un null node, renvoie CharacterDataNode.

void QDomCharacterData::replaceData(unsigned long offset, unsigned long count, const QString &arg)

Remplace la sous-chaîne de longueur count, commençant à la position offset, par la chaîne arg.

void QDomCharacterData::setData(const QString &data)

Définit la chaîne de cet objet sur « data ».

Voir aussi data().

QString QDomCharacterData::substringData(unsigned long offset, unsigned long count)

Renvoie la sous-chaîne de longueur count à partir de la position offset.

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

Attribue la fonction ` other ` à ces données de type chaîne de caractères.

Les données de la copie sont partagées (copie superficielle) : la modification d'un nœud entraîne également la modification de l'autre. Si vous souhaitez effectuer une copie profonde, utilisez la fonction cloneNode().

© 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.