Objet XmlCharacterData

L'interface XmlCharacterData fournit des fonctions communes des nœuds XmlText et XmlComment

XmlCharacterData est la super interface des nœuds XmlText et XmlComment . Les documents ne contiennent noeuds XmlCharacterData, ils ne contiennent que XmlText nœuds et XmlComment nœuds. Mais comme ces deux nœuds ont des fonctions similaires, ces fonctions sont définies ici afin que XmlText et XmlComment puissent en hériter.

Héritage

Attributs des membres

data

String, le texte contenu dans le nœud

1
String XmlCharacterData.data;

length

Entier, le nombre de caractères contenus dans le nœud

1
readonly Integer XmlCharacterData.length;

nodeType

Entier, renvoie le type de nœud du nœud

1
readonly Integer XmlCharacterData.nodeType;

Le nodeType de différents objets renverra des valeurs différentes:

• XmlElement : ELEMENT_NODE (1)
• XmlAttr : ATTRIBUTE_NODE (2)
• XmlText : TEXT_NODE (3)
• XmlCDATASection : CDATA_SECTION_NODE (4)
• XmlProcessingInstruction : PROCESSING_INSTRUCTION_NODE (7)
• XmlComment : COMMENT_NODE (8)
• XmlDocument : DOCUMENT_NODE (9)
• XmlDocumentType : DOCUMENT_TYPE_NODE (10)

nodeName

String, renvoie le nom du nœud, selon son type

1
readonly String XmlCharacterData.nodeName;

Le nodeName de différents objets renverra des valeurs différentes:

• XmlElement : nom de l'élément
• XmlAttr : nom d'attribut
• XmlText : #text
• XmlCDATASection : # cdata-section
• XmlProcessingInstruction : renvoie la cible cible spécifiée
• XmlComment : XmlComment
• XmlDocument : #document
• XmlDocumentType : nom doctype

nodeValue

String, renvoie le nom du nœud, selon son type

1
String XmlCharacterData.nodeValue;

Le nodeName de différents objets renverra des valeurs différentes:

• XmlElement : null
• XmlAttr : la valeur de l'attribut
• XmlText : le contenu du nœud
• XmlCDATASection : le contenu du nœud
• XmlProcessingInstruction : XmlProcessingInstruction les données de contenu spécifiées
• XmlComment : texte du commentaire
• XmlDocument : null
• XmlDocumentType : null

ownerDocument

XmlDocument , retourne l'élément racine du nœud (objet XmlDocument )

1
readonly XmlDocument XmlCharacterData.ownerDocument;

parentNode

XmlNode , peut retourner le nœud parent d'un nœud

1
readonly XmlNode XmlCharacterData.parentNode;

childNodes

XmlNodeList , renvoie la liste des nœuds enfants du nœud spécifié

1
readonly XmlNodeList XmlCharacterData.childNodes;

firstChild

XmlNode , retourne le premier nœud enfant du nœud

1
readonly XmlNode XmlCharacterData.firstChild;

lastChild

XmlNode , retourne le dernier nœud enfant du nœud

1
readonly XmlNode XmlCharacterData.lastChild;

previousSibling

XmlNode , renvoie le nœud immédiatement avant un certain nœud (au même niveau de l'arborescence), s'il n'y a pas de tel nœud, cet attribut retourne null

1
readonly XmlNode XmlCharacterData.previousSibling;

nextSibling

XmlNode , retourne le nœud immédiatement après un élément (dans le même niveau d'arborescence), s'il n'y a pas de tel nœud, la propriété retourne null

1
readonly XmlNode XmlCharacterData.nextSibling;

Fonction membre

substringData

Extraire la sous-chaîne du nœud

1
2
String XmlCharacterData.substringData(Integer offset,
    Integer count);

Paramètres d'appel:

• offset : Entier, la position du premier caractère à renvoyer
• count : Integer, le nombre de caractères de la sous-chaîne à renvoyer

Résultat de retour:

• String , renvoie la chaîne extraite

appendData

Ajouter la chaîne au nœud

1
XmlCharacterData.appendData(String arg);

Paramètres d'appel:

• arg : String, chaîne à ajouter au nœud

insertData

Insérer une chaîne dans le nœud

1
2
XmlCharacterData.insertData(Integer offset,
    String arg);

Paramètres d'appel:

• offset : Entier, la position du caractère où la chaîne doit être insérée dans le nœud
• arg : String, la chaîne à insérer

deleteData

Supprimer le texte du nœud

1
2
XmlCharacterData.deleteData(Integer offset,
    Integer count);

Paramètres d'appel:

• offset : Integer, la position du premier caractère à supprimer
• count : Integer, le nombre de caractères à supprimer

replaceData

Remplacez les caractères du nœud par la chaîne spécifiée

1
2
3
XmlCharacterData.replaceData(Integer offset,
    Integer count,
    String arg);

Paramètres d'appel:

• offset : Integer, la position du caractère du nœud à remplacer
• count : Integer, le nombre de caractères à remplacer
• arg : String, la chaîne à insérer

hasChildNodes

Demander s'il existe des nœuds enfants

1
Boolean XmlCharacterData.hasChildNodes();

Résultat de retour:

• Boolean , retourne true s'il y a des nœuds enfants, sinon retourne false

normalize

Fusionner les nœuds de texte adjacents et supprimer les nœuds de texte vides

1
XmlCharacterData.normalize();

Cette méthode traversera tous les nœuds descendants du nœud actuel et normalisera le document en supprimant le nœud Text vide et en fusionnant tous les nœuds Text adjacents. Cette méthode est utile pour simplifier la structure de l'arborescence du document après l'insertion ou la suppression de nœuds.

cloneNode

Créer une copie exacte du nœud spécifié

1
XmlNode XmlCharacterData.cloneNode(Boolean deep = true);

Paramètres d'appel:

• deep : Boolean, s'il faut copier en profondeur, lorsque true, le nœud cloné clonera tous les nœuds enfants du nœud d'origine

Résultat de retour:

• XmlNode , retourne le nœud copié

Cette méthode copiera et retournera une copie du nœud qui l'a appelée. Si le paramètre qui lui est passé est vrai, il copiera également de manière récursive tous les descendants du nœud actuel. Sinon, il ne copie que le nœud actuel. Le nœud renvoyé n'appartient pas à l'arborescence du document et sa propriété parentNode est null. Lorsque le nœud Elément est copié, tous ses attributs seront copiés.

lookupPrefix

Renvoie le préfixe correspondant à l'URI d'espace de noms spécifié sur le nœud actuel

1
String XmlCharacterData.lookupPrefix(String namespaceURI);

Paramètres d'appel:

• namespaceURI : String, spécifiez l'URI d'espace de noms correspondant

Résultat de retour:

• String , renvoie le préfixe correspondant, renvoie null s'il ne correspond pas

lookupNamespaceURI

Renvoie l'URI de l'espace de noms qui correspond au préfixe spécifié sur le nœud actuel

1
String XmlCharacterData.lookupNamespaceURI(String prefix);

Paramètres d'appel:

• prefix : String, spécifiez le préfixe correspondant

Résultat de retour:

• String , renvoie l'URI d'espace de noms correspondant, renvoie null s'il ne correspond pas

insertBefore

Insérer un nouveau nœud enfant avant le nœud enfant existant

1
2
XmlNode XmlCharacterData.insertBefore(XmlNode newChild,
    XmlNode refChild);

Paramètres d'appel:

• newChild : XmlNode , insérez un nouveau nœud
• refChild : XmlNode , insérez un nouveau nœud avant ce nœud

Résultat de retour:

• XmlNode , renvoie le nouveau nœud enfant

Si newChild existe déjà dans l'arborescence du document, il sera supprimé de l'arborescence du document, puis réinséré dans sa nouvelle position. Les nœuds d'un document (ou les nœuds créés par un document) ne peuvent pas être insérés dans un autre document. Autrement dit, la propriété ownerDocument de newChild doit être la même que la propriété ownerDocument du nœud actuel.

insertAfter

Insérer un nouveau nœud enfant après le nœud enfant existant

1
2
XmlNode XmlCharacterData.insertAfter(XmlNode newChild,
    XmlNode refChild);

Paramètres d'appel:

• newChild : XmlNode , insérez un nouveau nœud
• refChild : XmlNode , insérez un nouveau nœud après ce nœud

Résultat de retour:

• XmlNode , renvoie le nouveau nœud enfant

Si newChild existe déjà dans l'arborescence du document, il sera supprimé de l'arborescence du document, puis réinséré dans sa nouvelle position. Les nœuds d'un document (ou les nœuds créés par un document) ne peuvent pas être insérés dans un autre document. Autrement dit, la propriété ownerDocument de newChild doit être la même que la propriété ownerDocument du nœud actuel.

appendChild

Ajouter un nouveau nœud enfant à la fin de la liste des nœuds enfants du nœud

1
XmlNode XmlCharacterData.appendChild(XmlNode newChild);

Paramètres d'appel:

• newChild : XmlNode , spécifiez le nœud ajouté

Résultat de retour:

• XmlNode , retourne ce nouveau nœud enfant

Si newChild existe déjà dans l'arborescence du document, il sera supprimé de l'arborescence du document, puis réinséré dans sa nouvelle position. Les nœuds d'un document (ou les nœuds créés par un document) ne peuvent pas être insérés dans un autre document. Autrement dit, la propriété ownerDocument de newChild doit être la même que la propriété ownerDocument du nœud actuel.

replaceChild

Remplacer un nœud enfant par un autre

1
2
XmlNode XmlCharacterData.replaceChild(XmlNode newChild,
    XmlNode oldChild);

Paramètres d'appel:

• newChild : XmlNode , spécifiez un nouveau nœud
• oldChild : XmlNode , spécifiez le nœud à remplacer

Résultat de retour:

• XmlNode , si le remplacement réussit, cette méthode peut retourner le nœud remplacé, si le remplacement échoue, elle retourne null

Si newChild existe déjà dans l'arborescence du document, il sera supprimé de l'arborescence du document, puis réinséré dans sa nouvelle position. Les nœuds d'un document (ou les nœuds créés par un document) ne peuvent pas être insérés dans un autre document. Autrement dit, la propriété ownerDocument de newChild doit être la même que la propriété ownerDocument du nœud actuel.

removeChild

Supprimer un nœud de la liste des nœuds enfants

1
XmlNode XmlCharacterData.removeChild(XmlNode oldChild);

Paramètres d'appel:

• oldChild : XmlNode , spécifiez le nœud à supprimer

Résultat de retour:

• XmlNode , si la suppression est réussie, cette méthode peut retourner le nœud supprimé, si elle échoue, elle retourne null

toString

Renvoie la représentation sous forme de chaîne de l'objet, renvoie généralement "[Native Object]", l'objet peut être réimplémenté selon ses propres caractéristiques

1
String XmlCharacterData.toString();

Résultat de retour:

• String , renvoie la représentation sous forme de chaîne de l'objet

toJSON

Renvoie la représentation au format JSON de l'objet, renvoie généralement une collection d'attributs lisibles définis par l'objet

1
Value XmlCharacterData.toJSON(String key = "");

Paramètres d'appel:

• key : chaîne, inutilisée

Résultat de retour:

• Value , renvoie une valeur contenant JSON sérialisable