|
JavaTM Platform Standard Ed. 6 |
|||||||||
전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 |
public interface CharacterData
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」를 참조해 주세요.
필드의 개요 |
---|
메소드의 개요 | |
---|---|
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 |
메소드의 상세 |
---|
String getData() throws DOMException
CharacterData
노드에 포함할 수 있는 데이터의 양을 제한하지 않습니다. 그러나, 어느 노드의 데이터 전체가 단일의 DOMString
에 들어가지 않는 경우는, 구현의 제한이 유효하게 됩니다. 이 경우, 사용자는 substringData
를 호출해, 데이터를 적절한 사이즈에 분할해 취득할 수 있습니다.
DOMException
- DOMSTRING_SIZE_ERR:반환되는 문자수가 너무 많아서
구현 플랫폼상의 DOMString
변수에 들어가지 않는 경우void setData(String data) throws DOMException
CharacterData
노드에 포함할 수 있는 데이터의 양을 제한하지 않습니다. 그러나, 어느 노드의 데이터 전체가 단일의 DOMString
에 들어가지 않는 경우는, 구현의 제한이 유효하게 됩니다. 이 경우, 사용자는 substringData
를 호출해, 데이터를 적절한 사이즈에 분할해 취득할 수 있습니다.
DOMException
- NO_MODIFICATION_ALLOWED_ERR:노드가 읽어내 전용의 경우int getLength()
data
메소드 및 substringData
메소드를 개입시켜 취득 가능한 16 비트 단위의 수입니다. CharacterData
노드가 빈 상태(empty)의 경우, 값은 제로가 됩니다.
String substringData(int offset, int count) throws DOMException
offset
- 추출하는 부분 캐릭터 라인의 개시 오프셋(offset)count
- 추출하는 16 비트 단위의 수
offset
와
count
의 합계가 length
를 넘는 경우,
데이터의 말미까지 포함되는 모든 16 비트 단위가 반환된다
DOMException
- INDEX_SIZE_ERR:지정된 offset
하지만 0 보다 작은 값인지,data
내의 16 비트 단위의 수보다 큰 경우.
또는, 지정된 count
가 0 보다 작은 값이다
경우
DOMString
에 들어가지 않는 경우void appendData(String arg) throws DOMException
data
에 의해, 지정된 data
와 DOMString
를 연결한 것에 액세스 할 수 있습니다.
arg
- 추가되는 DOMString
DOMException
- NO_MODIFICATION_ALLOWED_ERR:이 노드가 읽어내 전용의 경우void insertData(int offset, String arg) throws DOMException
offset
- 삽입 위치의 문자 오프셋(offset)arg
- 삽입되는 DOMString
DOMException
- INDEX_SIZE_ERR:지정된 offset
하지만 0 보다 작은 값인지,data
내의 16 비트 단위의 수보다 크다
경우
void deleteData(int offset, int count) throws DOMException
data
와 length
로 변경이 반영됩니다.
offset
- 삭제를 개시하는 위치의 오프셋(offset)count
- 삭제하는 16 비트 단위의 수. offset
와
count
의 합계가
length
를 넘는 경우,offset
로부터 데이터의 말미까지
존재하는 모든 16 비트 단위가 삭제된다
DOMException
- INDEX_SIZE_ERR:지정된 offset
하지만 0 보다 작은 값인지,data
내의 16 비트 단위의 수보다 크다
경우. 또는, 지정된 count
가 0 보다 작은 값이다
경우
void replaceData(int offset, int count, String arg) throws DOMException
offset
- 치환을 개시하는 위치의 오프셋(offset)count
- 옮겨놓는 16 비트 단위의 수. offset
와
count
의 합계가
length
를 넘는 경우,offset
로부터 데이터의 말미까지 존재하는 모든 16 비트 단위가
옮겨놓을 수 있다 (그 범위에 대해서 remove
메소드와
append
메소드를 연속해 호출했을 경우와
같은 결과)arg
- 주어진(given) 범위와 옮겨놓을 수 있다
DOMString
DOMException
- INDEX_SIZE_ERR:지정된 offset
하지만 0 보다 작은 값인지,data
내의 16 비트 단위의 수보다 크다
경우. 또는, 지정된 count
가 0 보다 작은 값이다
경우
|
JavaTM Platform Standard Ed. 6 |
|||||||||
전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.