org.w3c.dom
인터페이스 CharacterData

모든 슈퍼 인터페이스:

Node

알려진 서브 인터페이스 목록 :

CDATASection, Comment, 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) 노드로부터 소정의 데이터 범위를 추출합니다.

인터페이스 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 노드가 비어있는 경우, 값은 제로가 됩니다.

substringData

String  substringData(int offset,
                     int count)
                     throws DOMException 

노드로부터 소정의 데이터 범위를 추출합니다.

파라미터:

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

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

반환값:

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

예외:

DOMException - INDEX_SIZE_ERR: 지정된 offset이 잘못된 값 인지, data 내의 16 비트 단위의 수보다 큰 경우, 또는 지정된 count이 잘못된 값 의 경우
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이 잘못된 값 인지, 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이 잘못된 값 인지, data 내의 16 비트 단위의 수보다 큰 경우. 또는 지정된 count이 잘못된 값 인 경우
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 - 소정의 범위와 옮겨놓을 수 있는 DOMString

예외:

DOMException - INDEX_SIZE_ERR: 지정된 offset이 잘못된 값 인지, data 내의 16 비트 단위의 수보다 큰 경우. 또는 지정된 count이 잘못된 값 인 경우
NO_MODIFICATION_ALLOWED_ERR: 이 노드가 읽기 전용 의 경우