org.w3c.dom
인터페이스 CharacterData

모든 슈퍼 인터페이스:

Node

기존의 서브 인터페이스의 일람:

CDATASection , Comment , Text , Text

public interface CharacterData
extends Node 

CharacterData 인터페이스는, 속성과 메소드세트를 추가해 Node 를 확장하는 것으로써, DOM 내의 문자 데이터에 액세스 할 수 있도록(듯이) 합니다. 이러한 세트에 대해서는, 이것들을 실제로 사용하는 객체의 항으로 설명하는 것이 아니라, 여기서 정리해 설명해 둡니다. 직접 CharacterData 에 대응하는 DOM 객체는 존재하지 않습니다. 한편,Text 등의 그 외의 객체는 CharacterData 로부터 인터페이스를 상속합니다. 이 인터페이스에 포함되는 모든 offsets 는 0 으로 시작됩니다.

DOMString 인터페이스의 해설에서도 접했습니다만, DOM 에 포함되는 텍스트 캐릭터 라인은 UTF-16, 즉 16 비트를 1 단위로 하는 순서로 표현됩니다. 다음의 설명에서는, 「16 비트 단위」라고 하는 표현으로, CharacterData 에의 인덱스부가 16 비트 단위로 행해진다고 하는 것을 나타냅니다.

「Document Object Model (DOM) Level 3 Core Specification」를 참조해 주세요.

필드의 개요

인터페이스 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 () 이하의 data 메소드 및 substringData 메소드를 개입시켜 취득 가능한 16 비트 단위의 수입니다.
void	insertData (int offset, String arg) 지정된 16 비트 단위의 오프셋(offset)에 캐릭터 라인을 삽입합니다.
void	replaceData (int offset, int count, String arg) 지정된 캐릭터 라인으로, 지정된 16 비트 단위의 오프셋(offset) 이후의 문자를 옮겨놓습니다.
void	setData (String data) 이 인터페이스를 구현하는 노드의 문자 데이터입니다.
String	substringData (int offset, int count) 노드로부터 주어진(given) 데이터 범위를 추출합니다.

인터페이스 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 

이 인터페이스를 구현하는 노드의 문자 데이터입니다. 일반적으로, DOM 구현은,CharacterData 노드에 포함할 수 있는 데이터의 양을 제한하지 않습니다. 그러나, 어느 노드의 데이터 전체가 단일의 DOMString 에 들어가지 않는 경우는, 구현의 제한이 유효하게 됩니다. 이 경우, 사용자는 substringData 를 호출해, 데이터를 적절한 사이즈에 분할해 취득할 수 있습니다.

예외:

DOMException - NO_MODIFICATION_ALLOWED_ERR:노드가 읽어내 전용의 경우

getLength

int getLength()

이하의 data 메소드 및 substringData 메소드를 개입시켜 취득 가능한 16 비트 단위의 수입니다. CharacterData 노드가 빈 상태(empty)의 경우, 값은 제로가 됩니다.

substringData

String  substringData(int offset,
                     int count)
                     throws DOMException 

노드로부터 주어진(given) 데이터 범위를 추출합니다.

파라미터:

offset - 추출하는 부분 캐릭터 라인의 개시 오프셋(offset)

count - 추출하는 16 비트 단위의 수

반환값:

지정된 부분 캐릭터 라인. offset 와 count 의 합계가 length 를 넘는 경우, 데이터의 말미까지 포함되는 모든 16 비트 단위가 반환된다

예외:

DOMException - INDEX_SIZE_ERR:지정된 offset 하지만 0 보다 작은 값인지,data 내의 16 비트 단위의 수보다 큰 경우. 또는, 지정된 count 가 0 보다 작은 값이다 경우
DOMSTRING_SIZE_ERR:텍스트의 지정 범위가 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)에 캐릭터 라인을 삽입합니다.

파라미터:

offset - 삽입 위치의 문자 오프셋(offset)

arg - 삽입되는 DOMString

예외:

DOMException - INDEX_SIZE_ERR:지정된 offset 하지만 0 보다 작은 값인지,data 내의 16 비트 단위의 수보다 크다 경우
NO_MODIFICATION_ALLOWED_ERR:이 노드가 읽어내 전용의 경우

deleteData

void deleteData(int offset,
                int count)
                throws DOMException 

노드로부터 지정 범위의 16 비트 단위를 삭제합니다. 성공했을 경우,data 와 length 로 변경이 반영됩니다.

파라미터:

offset - 삭제를 개시하는 위치의 오프셋(offset)

count - 삭제하는 16 비트 단위의 수. offset 와 count 의 합계가 length 를 넘는 경우,offset 로부터 데이터의 말미까지 존재하는 모든 16 비트 단위가 삭제된다

예외:

DOMException - INDEX_SIZE_ERR:지정된 offset 하지만 0 보다 작은 값인지,data 내의 16 비트 단위의 수보다 크다 경우. 또는, 지정된 count 가 0 보다 작은 값이다 경우
NO_MODIFICATION_ALLOWED_ERR:이 노드가 읽어내 전용의 경우

replaceData

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

지정된 캐릭터 라인으로, 지정된 16 비트 단위의 오프셋(offset) 이후의 문자를 옮겨놓습니다.

파라미터:

offset - 치환을 개시하는 위치의 오프셋(offset)

count - 옮겨놓는 16 비트 단위의 수. offset 와 count 의 합계가 length 를 넘는 경우,offset 로부터 데이터의 말미까지 존재하는 모든 16 비트 단위가 옮겨놓을 수 있다 (그 범위에 대해서 remove 메소드와 append 메소드를 연속해 호출했을 경우와 같은 결과)

arg - 주어진(given) 범위와 옮겨놓을 수 있다 DOMString

예외:

DOMException - INDEX_SIZE_ERR:지정된 offset 하지만 0 보다 작은 값인지,data 내의 16 비트 단위의 수보다 크다 경우. 또는, 지정된 count 가 0 보다 작은 값이다 경우
NO_MODIFICATION_ALLOWED_ERR:이 노드가 읽어내 전용의 경우