ОбъектXmlCharacterData

Интерфейс XmlCharacterData предоставляетXmlTextиXmlCommentОбщие функции узлов

XmlCharacterData — этоXmlTextиXmlCommentСуперинтерфейс узла. Документы никогда не содержат узлов XmlCharacterData, они содержат толькоXmlTextсумма узловXmlCommentузел. Но поскольку оба узла имеют схожую функциональность, эти функции здесь определены так, чтоXmlTextиXmlCommentЭто может передаваться по наследству.

отношения наследства

свойства члена

data

Строка, текст, содержащийся в этом узле.

1
String XmlCharacterData.data;

length

Целое число, количество символов, содержащихся в этом узле.

1readonly Integer XmlCharacterData.length;

nodeType

Целое число, возвращает тип узла.

1readonly Integer XmlCharacterData.nodeType;

NodeType разных объектов будет возвращать разные значения:

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: ДОКУМЕНТ_НОД(9)
XmlDocumentType: DOCUMENT_TYPE_NODE(10)

nodeName

Строка, возвращает имя узла в соответствии с его типом.

1
readonly String XmlCharacterData.nodeName;

Имя узла разных объектов будет возвращать разные значения:

XmlElement:имя элемента
XmlAttr: имя атрибута
XmlText: #текст
XmlCDATASection: #cdata-раздел
XmlProcessingInstruction: Возвращает указанную целевую цель
XmlComment: #комментарий
XmlDocument: #документ
XmlDocumentType: имя типа документа

nodeValue

Строка, возвращает имя узла в соответствии с его типом.

1
String XmlCharacterData.nodeValue;

Имя узла разных объектов будет возвращать разные значения:

XmlElement: нулевой
XmlAttr: значение атрибута
XmlText: содержимое узла
XmlCDATASection: содержимое узла
XmlProcessingInstruction: Возвращает указанные данные содержимого.
XmlComment: текст аннотации
XmlDocument: нулевой
XmlDocumentType: нулевой

ownerDocument

XmlDocument, возвращает корневой элемент узла (XmlDocumentобъект)

1readonly XmlDocument XmlCharacterData.ownerDocument;

parentNode

XmlNode, может вернуть родительский узел узла

1readonly XmlNode XmlCharacterData.parentNode;

childNodes

XmlNodeList, возвращает список дочерних узлов указанного узла

1readonly XmlNodeList XmlCharacterData.childNodes;

children

XmlNodeList, возвращает список узлов дочерних элементов указанного узла.

1readonly XmlNodeList XmlCharacterData.children;

firstChild

XmlNode, возвращает первый дочерний узел узла

1readonly XmlNode XmlCharacterData.firstChild;

lastChild

XmlNode, возвращает последний дочерний узел узла

1readonly XmlNode XmlCharacterData.lastChild;

previousSibling

XmlNode, возвращает узел, непосредственно предшествующий узлу (на том же уровне дерева). Если такого узла нет, то это свойство возвращает значение null.

1readonly XmlNode XmlCharacterData.previousSibling;

nextSibling

XmlNode, возвращает узел, следующий сразу за элементом (на том же уровне дерева). Если такого узла нет, атрибут возвращает значение null.

1readonly XmlNode XmlCharacterData.nextSibling;

firstElementChild

XmlNode, возвращает первый дочерний элемент узла узла

1readonly XmlNode XmlCharacterData.firstElementChild;

lastElementChild

XmlNode, возвращает последний дочерний элемент узла узла

1readonly XmlNode XmlCharacterData.lastElementChild;

previousElementSibling

XmlNode, возвращает узел элемента, непосредственно предшествующий узлу (на том же уровне дерева). Если такого узла нет, то это свойство возвращает значение null.

1readonly XmlNode XmlCharacterData.previousElementSibling;

nextElementSibling

XmlNode, возвращает узел элемента, следующий сразу за элементом (на том же уровне дерева). Если такого узла нет, атрибут возвращает значение null.

1readonly XmlNode XmlCharacterData.nextElementSibling;

textContent

Строка, запрашивает и устанавливает текст выбранного элемента. При запросе возвращает значения всех текстовых узлов внутри узла элемента; при установке удаляет все дочерние узлы и заменяет их одним текстовым узлом.

1
String XmlCharacterData.textContent;

функция-член

substringData

Извлечь подстроку из узла

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

Параметры звонка:

offset: целое число, позиция первого возвращаемого символа.
count: целое число, количество символов в возвращаемой подстроке.

Результаты возврата:

String, возвращает извлеченную строку

appendData

Добавить строку в узел

1
XmlCharacterData.appendData(String arg);

Параметры звонка:

arg: Строка, строка, добавляемая к узлу.

insertData

Вставить строку в узел

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

Параметры звонка:

offset: целое число, позиция символа, в которой строка должна быть вставлена в узел.
arg: Строка, строка, которую нужно вставить.

deleteData

Удалить текст из узла

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

Параметры звонка:

offset: целое число, позиция первого удаляемого символа.
count: целое число, количество символов для удаления.

replaceData

Заменить символы узла указанной строкой

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

Параметры звонка:

offset: целое число, позиция символа заменяемого узла.
count: целое число, количество символов для замены.
arg: Строка, строка, которую нужно вставить.

hasChildNodes

Запросить, есть ли дочерние узлы

1
Boolean XmlCharacterData.hasChildNodes();

Результаты возврата:

Boolean, возвращает true, если есть дочерние узлы, в противном случае возвращает false

normalize

Объединить соседние текстовые узлы и удалить пустые текстовые узлы.

1XmlCharacterData.normalize();

Этот метод пройдет через все узлы-потомки текущего узла и нормализует документ, удалив пустые узлы Text и объединив все соседние узлы Text. Этот метод полезен для упрощения структуры дерева документа после вставки или удаления узлов.

cloneNode

Создает точную копию указанного узла

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

Параметры звонка:

deep: логическое значение, следует ли выполнять глубокое копирование. Если установлено значение true, клонированный узел клонирует все дочерние узлы исходного узла.

Результаты возврата:

XmlNode, возвращает скопированный узел

Этот метод скопирует и вернет копию узла, на котором он был вызван. Если переданный ему аргумент верен, он также рекурсивно скопирует все узлы-потомки текущего узла. В противном случае он только копирует текущий узел. Возвращенный узел не принадлежит дереву документа, а его свойство родительский узел имеет значение null. При копировании узла Element будут скопированы все его свойства.

lookupPrefix

Возвращает префикс, соответствующий указанному URI пространства имен на текущем узле.

1
String XmlCharacterData.lookupPrefix(String namespaceURI);

Параметры звонка:

namespaceURI: строка, указывает соответствующий URI пространства имен.

Результаты возврата:

String, возвращает соответствующий префикс, возвращает ноль, если не совпадает.

lookupNamespaceURI

Возвращает URI пространства имен, соответствующий указанному префиксу на текущем узле.

1
String XmlCharacterData.lookupNamespaceURI(String prefix);

Параметры звонка:

prefix: строка, указывает соответствующий префикс.

Результаты возврата:

String, возвращает соответствующий URI пространства имен, возвращает значение null, если не совпадает.

insertBefore

Вставьте новый дочерний узел перед существующим дочерним узлом.

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

Параметры звонка:

newChild:XmlNode, вставить новый узел
refChild:XmlNode, вставьте новый узел перед этим узлом

Результаты возврата:

XmlNode, возвращает новый дочерний узел

Если newChild уже существует в дереве документов, он будет удален из дерева документов и повторно вставлен в новую позицию. Узлы из одного документа (или узлы, созданные одним документом) не могут быть вставлены в другой документ. То есть атрибут OwnerDocument объекта newChild должен совпадать с атрибутом OwnerDocument текущего узла.

insertAfter

Вставьте новый дочерний узел после существующего дочернего узла.

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

Параметры звонка:

newChild:XmlNode, вставить новый узел
refChild:XmlNode, вставьте новый узел после этого узла

Результаты возврата:

XmlNode, возвращает новый дочерний узел

appendChild

Добавляет новый дочерний узел в конец списка дочерних узлов узла.

1XmlNode XmlCharacterData.appendChild(XmlNode newChild);

Параметры звонка:

newChild:XmlNode, укажите добавленный узел

Результаты возврата:

XmlNode, возвращает этот новый дочерний узел

replaceChild

Заменить дочерний узел другим

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

Параметры звонка:

newChild:XmlNode, укажите новый узел
oldChild:XmlNode, указывает узел, который будет заменен

Результаты возврата:

XmlNode, Если замена прошла успешно, этот метод может вернуть замененный узел. Если замена не удалась, он возвращает значение null.

removeChild

Удалить узел из списка дочерних узлов

1XmlNode XmlCharacterData.removeChild(XmlNode oldChild);

Параметры звонка:

oldChild:XmlNode, указывает узел, который нужно удалить

Результаты возврата:

XmlNode, Если удаление прошло успешно, этот метод может вернуть удаленный узел. В случае неудачи он возвращает значение null.

toString

Возвращает строковое представление объекта. Обычно возвращается «[Native Object]». Объект может быть повторно реализован в соответствии с его собственными характеристиками.

1
String XmlCharacterData.toString();

Результаты возврата:

String, возвращает строковое представление объекта

toJSON

Возвращает представление объекта в формате JSON, обычно возвращая коллекцию читаемых свойств, определенных объектом.

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

Параметры звонка:

key: Строка, не используется.

Результаты возврата:

Value, возвращает значение, содержащее сериализуемый JSON

Руководство по разработке

Базовый модуль

встроенные объекты

модуль сообщества

ОбъектXmlCharacterData

отношения наследства

свойства члена

data

length

nodeType

nodeName

nodeValue

ownerDocument

parentNode

childNodes

children

firstChild

lastChild

previousSibling

nextSibling

firstElementChild

lastElementChild

previousElementSibling

nextElementSibling

textContent

функция-член

substringData

appendData

insertData

deleteData

replaceData

hasChildNodes

normalize

cloneNode

lookupPrefix

lookupNamespaceURI

insertBefore

insertAfter

appendChild

replaceChild

removeChild

toString

toJSON