Objecte objecte incorporat

objecte XmlText

Objecte XmlText que representa el contingut de text d'un element o atribut

Un node XmlText representa una seqüència de text sense format en un document XML. Com que el text sense format apareix als elements i atributs XML, sovint ho són els nodes XmlTextXmlElementnode iXmlAttrApareixen els nodes fills del node.

El node XmlText heretaXmlCharacterDatainterfície, a través de laXmlCharacterDataLa propietat de dades heretada per la interfície o deXmlNodeLa propietat nadevalue heretada per la interfície pot accedir al contingut de text del node XmlText.

utilitzar des deXmlCharacterDataEl mètode heretat o el mètode splitText() definit per la mateixa interfície XmlText pot operar el node XmlText. utilitzarXmlDocumentcreateTextNode per crear un nou node XmlText.

El node XmlText no té fills.

Per obtenir mètodes per eliminar nodes XmlText buits i combinar nodes XmlText adjacents del subarbre d'un document, vegeuXmlNode.normalizemètode.

relació hereditària

#lineWidth: 1.5 #font: Helvetica,sans-Serif #fontSize: 10 #leading: 1.6 #.this: fill=lightgray #.class: fill=white [<class>object|toString();toJSON()] [<class>XmlNode|nodeType;nodeName;nodeValue;ownerDocument;parentNode;childNodes;firstChild;lastChild;previousSibling;nextSibling|hasChildNodes();normalize();cloneNode();lookupPrefix();lookupNamespaceURI();insertBefore();insertAfter();appendChild();replaceChild();removeChild()] [<class>XmlCharacterData|data;length|substringData();appendData();insertData();deleteData();replaceData()] [<this>XmlText|splitText()] [<class>XmlCDATASection] [object] <:- [XmlNode] [XmlNode] <:- [XmlCharacterData] [XmlCharacterData] <:- [XmlText] [XmlText] <:- [XmlCDATASection] XmlNode nodeType nodeName nodeValue ownerDocument parentNode childNodes firstChild lastChild previousSibling nextSibling hasChildNodes() normalize() cloneNode() lookupPrefix() lookupNamespaceURI() insertBefore() insertAfter() appendChild() replaceChild() removeChild() XmlCharacterData data length substringData() appendData() insertData() deleteData() replaceData() object toString() toJSON() XmlText splitText() XmlCDATASection

Propietats dels membres

data

String, el text que conté aquest node

1
String XmlText.data;

length

Enter, el nombre de caràcters que conté aquest node

1
readonly Integer XmlText.length;

nodeType

Enter, retorna el tipus de node del node

1
readonly Integer XmlText.nodeType;

El nodeType de diferents objectes retornarà diferents valors:


nodeName

String, retorna el nom del node, segons el seu tipus

1
readonly String XmlText.nodeName;

El nodeName de diferents objectes retornarà diferents valors:


nodeValue

String, retorna el nom del node, segons el seu tipus

1
String XmlText.nodeValue;

El nodeName de diferents objectes retornarà diferents valors:


ownerDocument

XmlDocument, retorna l'element arrel del node (XmlDocumentobjecte)

1
readonly XmlDocument XmlText.ownerDocument;

parentNode

XmlNode, retorna el node pare d'un node

1
readonly XmlNode XmlText.parentNode;

childNodes

XmlNodeList, retorna una llista de nodes que són fills del node especificat

1
readonly XmlNodeList XmlText.childNodes;

firstChild

XmlNode, retorna el primer fill del node

1
readonly XmlNode XmlText.firstChild;

lastChild

XmlNode, retorna l'últim fill del node

1
readonly XmlNode XmlText.lastChild;

previousSibling

XmlNode, retorna el node immediatament abans d'un node (al mateix nivell d'arbre), si no hi ha aquest node, la propietat retorna null

1
readonly XmlNode XmlText.previousSibling;

nextSibling

XmlNode, retorna el node immediatament després d'un element (al mateix nivell d'arbre), si no hi ha aquest node, la propietat retorna null

1
readonly XmlNode XmlText.nextSibling;

funció de membre

splitText

Dividiu el node de text en dos nodes segons el desplaçament especificat

1
XmlText XmlText.splitText(Integer offset);

Paràmetres de trucada:

  • offset: Sencer, especifica on dividir els nodes de text. el valor inicial comença amb 0

Resultat de retorn:

  • XmlText, el node Text es divideix del node actual

Aquest mètode dividirà el node XmlText en dos nodes amb el desplaçament especificat. El node XmlText original es modificarà per contenir (però no incloure) el contingut del text fins a la posició especificada per offset. Es crearà un nou node XmlText per contenir tots els caràcters des de la posició de desplaçament (inclòs el caràcter en aquesta posició) fins al final del caràcter original. El nou node XmlText és el valor de retorn d'aquest mètode. A més, si el node XmlText original tenia un parentNode, el nou node XmlText s'inserirà en aquest node pare immediatament després del node original.

XmlCDATASectionLa interfície hereta la interfície XmlText,XmlCDATASectionEls nodes també poden utilitzar aquest mètode, tret que els nodes de nova creació ho sónXmlCDATASectionnode, no un node XmlText.


substringData

Extreu la subcadena del node

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

Paràmetres de trucada:

  • offset: Enter, la posició del primer caràcter a retornar
  • count: Enter, el nombre de caràcters de la subcadena a retornar

Resultat de retorn:

  • String, retorna la cadena extreta

appendData

afegiu una cadena al node

1
XmlText.appendData(String arg);

Paràmetres de trucada:

  • arg: String, la cadena que cal afegir al node

insertData

inseriu una cadena al node

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

Paràmetres de trucada:

  • offset: Enter, la posició del caràcter on inserir la cadena al node
  • arg: String, la cadena a inserir

deleteData

eliminar el text del node

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

Paràmetres de trucada:

  • offset: Enter, la posició del primer caràcter a eliminar
  • count: Enter, el nombre de caràcters que cal suprimir

replaceData

Substituïu els caràcters d'un node per la cadena especificada

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

Paràmetres de trucada:

  • offset: Enter, la posició del caràcter que el node ha de substituir
  • count: Enter, el nombre de caràcters a substituir
  • arg: String, la cadena a inserir

hasChildNodes

Consulta si hi ha un node fill

1
Boolean XmlText.hasChildNodes();

Resultat de retorn:

  • Boolean, retorna true si hi ha cap node fill, false en cas contrari

normalize

Combina els nodes de text adjacents i suprimeix els nodes de text buits

1
XmlText.normalize();

Aquest mètode iterarà sobre tots els nodes descendents del node actual, normalitzant el document eliminant els nodes de text buits, ja fusionant tots els nodes de text adjacents. Aquest mètode és útil per simplificar l'estructura de l'arbre del document després de la inserció o la supressió del node.


cloneNode

Creeu una còpia exacta del node especificat

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

Paràmetres de trucada:

  • deep: Booleà, si cal copiar en profunditat, quan és cert, el node clonat clonarà tots els nodes fills del node original

Resultat de retorn:

Aquest mètode copiarà i retornarà una còpia del node on s'ha cridat. Si l'argument que se li passa és cert, també copiarà de forma recursiva tots els descendents del node actual. En cas contrari, només copia el node actual. El node retornat no pertany a l'arbre del document i la seva propietat parentNode és nul·la. Quan es copia un node Element, es copien totes les seves propietats.


lookupPrefix

Retorna el prefix que coincideix amb l'URI de l'espai de noms especificat al node actual

1
String XmlText.lookupPrefix(String namespaceURI);

Paràmetres de trucada:

  • namespaceURI: Cadena, que especifica l'URI de l'espai de noms coincident

Resultat de retorn:

  • String, retorna el prefix coincident, no coincident retorna nul

lookupNamespaceURI

Retorna l'URI de l'espai de noms que coincideix amb el prefix especificat al node actual

1
String XmlText.lookupNamespaceURI(String prefix);

Paràmetres de trucada:

  • prefix: Cadena, especificant el prefix per coincidir

Resultat de retorn:

  • String, retorna l'URI de l'espai de noms coincident, que no coincideix retorna nul

insertBefore

Inseriu un nou node fill abans d'un node fill existent

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

Paràmetres de trucada:

  • newChild:XmlNode, inseriu un nou node
  • refChild:XmlNode, inseriu un nou node abans d'aquest node

Resultat de retorn:

  • XmlNode, retorna el nou node fill

Si newChild ja existeix a l'arbre del document, s'eliminarà de l'arbre del document i es tornarà a inserir a la seva nova posició. Els nodes d'un document (o nodes creats per un document) no es poden inserir en un altre document. És a dir, la propietat ownerDocument de newChild ha de ser la mateixa que la propietat ownerDocument del node actual.


insertAfter

Inseriu un nou node fill després d'un node fill existent

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

Paràmetres de trucada:

  • newChild:XmlNode, inseriu un nou node
  • refChild:XmlNode, inseriu un nou node després d'aquest node

Resultat de retorn:

  • XmlNode, retorna el nou node fill

Si newChild ja existeix a l'arbre del document, s'eliminarà de l'arbre del document i es tornarà a inserir a la seva nova posició. Els nodes d'un document (o nodes creats per un document) no es poden inserir en un altre document. És a dir, la propietat ownerDocument de newChild ha de ser la mateixa que la propietat ownerDocument del node actual.


appendChild

Afegiu un nou node fill al final de la llista de nodes secundaris del node

1
XmlNode XmlText.appendChild(XmlNode newChild);

Paràmetres de trucada:

  • newChild:XmlNode, especifica el node a afegir

Resultat de retorn:

  • XmlNode, retorna aquest nou node fill

Si newChild ja existeix a l'arbre del document, s'eliminarà de l'arbre del document i es tornarà a inserir a la seva nova posició. Els nodes d'un document (o nodes creats per un document) no es poden inserir en un altre document. És a dir, la propietat ownerDocument de newChild ha de ser la mateixa que la propietat ownerDocument del node actual.


replaceChild

substituir un node fill per un altre

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

Paràmetres de trucada:

  • newChild:XmlNode, especifica el nou node
  • oldChild:XmlNode, especifica el node que s'ha de substituir

Resultat de retorn:

  • XmlNode, si la substitució té èxit, aquest mètode pot tornar el node a substituir, si la substitució falla, tornarà nul

Si newChild ja existeix a l'arbre del document, s'eliminarà de l'arbre del document i es tornarà a inserir a la seva nova posició. Els nodes d'un document (o nodes creats per un document) no es poden inserir en un altre document. És a dir, la propietat ownerDocument de newChild ha de ser la mateixa que la propietat ownerDocument del node actual.


removeChild

Elimina un node de la llista de nodes fills

1
XmlNode XmlText.removeChild(XmlNode oldChild);

Paràmetres de trucada:

  • oldChild:XmlNode, especifica el node que s'ha de suprimir

Resultat de retorn:

  • XmlNode, si l'eliminació té èxit, aquest mètode pot tornar el node suprimit, si falla, tornarà nul

toString

Retorna la representació de cadena de l'objecte, generalment retorna "[Native Object]", l'objecte es pot reimplementar segons les seves pròpies característiques

1
String XmlText.toString();

Resultat de retorn:

  • String, retorna la representació de cadena de l'objecte

toJSON

Retorna la representació en format JSON de l'objecte, generalment retorna el conjunt de propietats llegibles definides per l'objecte

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

Paràmetres de trucada:

  • key: Corda, sense utilitzar

Resultat de retorn:

  • Value, retorna un valor que conté JSON serializable