Интерфейс CharacterData

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

Все известные подинтерфейсы:: CDATASection, Comment, Text

public interface CharacterData extends Node

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

Как объяснено в интерфейсе DOMString, текстовые строки в DOM представлены в формате UTF-16, то есть как последовательность 16-битовых единиц. В дальнейшем термин «16-битовые единицы» используется всякий раз, когда необходимо указать, что индексация в CharacterData выполняется в 16-битовых единицах.

См. также Спецификацию Document Object Model (DOM) Level 3 Core.

С:: 1.4, DOM Level 2

Краткое описание полей

Поля, объявленные в интерфейсе org.w3c.dom.Node

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-битовых единиц из узла.
`String`	`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)`	Данные символьного типа узла, реализующего этот интерфейс.
`String`	`substringData(int offset, int count)`	Извлекает диапазон данных из узла.

Методы, объявленные в интерфейсе org.w3c.dom.Node

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

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

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

setData

void setData(String data) throws DOMException

Возбращает:: 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: Возникает, если указанный диапазон текста не помещается в переменную DOMString.

appendData

void appendData(String arg) throws DOMException

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

Параметры:: arg - Строка для добавления.
Возбращает:: DOMException - NO_MODIFICATION_ALLOWED_ERR: Возникает, если этот узел является только для чтения.

insertData

void insertData(int offset, String arg) throws DOMException

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

Параметры:: offset - Смещение символа для вставки.; arg - Строка для вставки.
Возбращает:: 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-битовые единицы до конца данных заменяются; (т.е., эффект такой же, как вызов метода remove с тем же диапазоном, за которым следует вызов метода append).; arg - Строка, которой необходимо заменить диапазон.
Возбращает:: DOMException - INDEX_SIZE_ERR: Возникает, если указанное offset отрицательное или больше количества 16-битовых единиц в data, или если указанное count отрицательное.
NO_MODIFICATION_ALLOWED_ERR: Возникает, если этот узел является только для чтения.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.xml/org/w3c/dom/CharacterData.html