compact2, compact3

org.w3c.dom

Интерфейс CharacterData

Все Суперинтерфейсы:

Узел

Все Известные Подынтерфейсы:

CDATASection, Комментарий, текст, текст

public interface CharacterData
extends Node

CharacterData интерфейс расширяет Узел с помощью ряда атрибутов и методов для того, чтобы получить доступ к символьным данным в ДОМЕ. Для ясности этот набор определяется здесь, а не на каждом объекте, который использует эти атрибуты и методы. Никакие объекты ДОМА не соответствуют непосредственно CharacterData, хотя Text и другие действительно наследовали интерфейс от этого. Все offsets в этом интерфейсе запускаются с 0.

Как объяснено в DOMString интерфейс, текстовые строки в ДОМЕ представляются в UTF-16, то есть как последовательность 16-разрядных модулей. В следующем термин 16-разрядные модули используются всякий раз, когда необходимый, чтобы указать, что индексация на CharacterData делается в 16-разрядных модулях.

См. также Объектную модель документа (ДОМ) Спецификация Ядра Уровня 3.

Полевая Сводка

Поля, наследованные от интерфейса org.w3c.dom. Узел

ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE

Сводка метода

Модификатор и Тип	Метод и Описание
void	appendData(String arg) Добавьте строку до конца символьных данных узла.
void	deleteData(int offset, int count) Удалите диапазон 16-разрядных модулей от узла.
Строка	getData() Символьные данные узла, который реализует этот интерфейс.
int	getLength() Число 16-разрядных модулей, которые доступны через data и substringData метод ниже.
void	insertData(int offset, String arg) Вставьте строку при указанном 16-разрядном смещении модуля.
void	replaceData(int offset, int count, String arg) Замените символы, запускающиеся при указанном 16-разрядном смещении модуля с указанной строки.
void	setData(String data) Символьные данные узла, который реализует этот интерфейс.
Строка	substringData(int offset, int count) Извлекает диапазон данных от узла.

Методы, наследованные от интерфейса org.w3c.dom. Узел

appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData

Деталь метода

getData

String getData()
        throws DOMException

Символьные данные узла, который реализует этот интерфейс. Реализация ДОМА, возможно, не помещает произвольные пределы в объем данных, который может быть сохранен в a CharacterData узел. Однако, пределы реализации могут означать, что полнота данных узла, возможно, не вписывается в сингл DOMString. В таких случаях пользователь может вызвать substringData получать данные в соответственно размерных частях.

Броски:

DOMException - DOMSTRING_SIZE_ERR: Повышенный, когда это возвратило бы больше символов чем, помещаются в a DOMString переменная на платформе реализации.

setData

void setData(String data)
      throws DOMException

Символьные данные узла, который реализует этот интерфейс. Реализация ДОМА, возможно, не помещает произвольные пределы в объем данных, который может быть сохранен в a CharacterData узел. Однако, пределы реализации могут означать, что полнота данных узла, возможно, не вписывается в сингл DOMString. В таких случаях пользователь может вызвать substringData получать данные в соответственно размерных частях.

Броски:

DOMException - NO_MODIFICATION_ALLOWED_ERR: Повышенный, когда узел только для чтения.

getLength

int getLength()

Число 16-разрядных модулей, которые доступны через data и substringData метод ниже. У этого может быть нуль значения, то есть, CharacterData узлы могут быть пустыми.

substringData

String substringData(int offset,
                     int count)
              throws DOMException

Извлекает диапазон данных от узла.

Параметры:

offset - Запустите смещение подстроки, чтобы извлечь.

count - Число 16-разрядных модулей, чтобы извлечь.

Возвраты:

Указанная подстрока. Если сумма offset и count превышает length, тогда все 16-разрядные модули до конца данных возвращаются.

Броски:

DOMException - INDEX_SIZE_ERR: Повышенный, если указанное offset отрицательно или больше чем число 16-разрядных модулей в data, или если указанное count отрицательно.
DOMSTRING_SIZE_ERR: Повышенный, если указанный диапазон текста не вписывается в a DOMString.

appendData

void appendData(String arg)
         throws DOMException

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

Параметры:

arg - DOMString добавлять.

Броски:

DOMException - NO_MODIFICATION_ALLOWED_ERR: Повышенный, если этот узел только для чтения.

insertData

void insertData(int offset,
                String arg)
         throws DOMException

Вставьте строку при указанном 16-разрядном смещении модуля.

Параметры:

offset - Символьное смещение, при котором можно вставить.

arg - DOMString вставить.

Броски:

DOMException - INDEX_SIZE_ERR: Повышенный, если указанное offset отрицательно или больше чем число 16-разрядных модулей в data.
NO_MODIFICATION_ALLOWED_ERR: Повышенный, если этот узел только для чтения.

deleteData

void deleteData(int offset,
                int count)
         throws DOMException

Удалите диапазон 16-разрядных модулей от узла. На успех, data и length отразите изменение.

Параметры:

offset - Смещение, из которого можно начать удалять.

count - Число 16-разрядных модулей, чтобы удалить. Если сумма offset и count превышает length тогда все 16-разрядные модули от offset до конца данных удаляются.

Броски:

DOMException - INDEX_SIZE_ERR: Повышенный, если указанное offset отрицательно или больше чем число 16-разрядных модулей в data, или если указанное count отрицательно.
NO_MODIFICATION_ALLOWED_ERR: Повышенный, если этот узел только для чтения.

replaceData

void replaceData(int offset,
                 int count,
                 String arg)
          throws DOMException

Замените символы, запускающиеся при указанном 16-разрядном смещении модуля с указанной строки.

Параметры:

offset - Смещение, от которого можно начать заменять.

count - Число 16-разрядных модулей, чтобы заменить. Если сумма offset и count превышает length, тогда все 16-разрядные модули до конца данных заменяются; (то есть, эффект является тем же самым как a remove вызов метода с тем же самым диапазоном, сопровождаемым append вызов метода).

arg - DOMString которым диапазон должен быть заменен.

Броски:

DOMException - INDEX_SIZE_ERR: Повышенный, если указанное offset отрицательно или больше чем число 16-разрядных модулей в data, или если указанное count отрицательно.
NO_MODIFICATION_ALLOWED_ERR: Повышенный, если этот узел только для чтения.