class CharacterData

The <code> CharacterData </code> interface extends Node with a set of attributes and methods for accessing character data in the DOM. More...

Full nameDOM::CharacterData
Definition#include <dom_text.h>
InheritsDOM::Node [public ]
Inherited byCDATASection, Comment, Text
List of all Methods
Annotated List
Files
Globals
Hierarchy
Index

Public Methods

Protected Methods


Detailed Description

The <code> CharacterData </code> interface extends Node with a set of attributes and methods for accessing character data in the DOM. For clarity this set is defined here rather than on each object that uses these attributes and methods. No DOM objects correspond directly to <code> CharacterData </code> , though <code> Text </code> and others do inherit the interface from it. All <code> offset</code>s in this interface start from 0.

 CharacterData ()

CharacterData

 CharacterData (const CharacterData &other)

CharacterData

 CharacterData (const Node &other)

CharacterData

CharacterData &  operator = (const Node &other)

operator =

Reimplemented from Node.

CharacterData &  operator = (const CharacterData &other)

operator =

Reimplemented from Node.

 ~CharacterData ()

~CharacterData

DOMString  data ()

data

[const]

The character data of the node that implements this interface. The DOM implementation may not put arbitrary limits on the amount of data that may be stored in a <code> CharacterData </code> node. However, implementation limits may mean that the entirety of a node's data may not fit into a single <code> DOMString </code> . In such cases, the user may call <code> substringData </code> to retrieve the data in appropriately sized pieces.

Throws: DOMException, DOMSTRING_SIZE_ERR:, Raised, when, it, would, return, more, characters, than, fit, in, a, <code>, DOMString, </code>, variable, on, the, implementation, platform.

void  setData ( const DOMString & )

setData

see data

Throws: DOMException, NO_MODIFICATION_ALLOWED_ERR:, Raised, when, the, node, is, readonly.

unsigned long  length ()

length

[const]

The number of characters that are available through <code> data </code> and the <code> substringData </code> method below. This may have the value zero, i.e., <code> CharacterData </code> nodes may be empty.

DOMString  substringData ( const unsigned long offset, const unsigned long count )

substringData

Extracts a range of data from the node.

DOMSTRING_SIZE_ERR: Raised if the specified range of text does not fit into a <code> DOMString </code> .

Parameters:
offsetStart offset of substring to extract.
countThe number of characters to extract.

Returns: The specified substring. If the sum of <code> offset </code> and <code> count </code> exceeds the <code> length </code> , then all characters to the end of the data are returned.

Throws: DOMException, INDEX_SIZE_ERR:, Raised, if, the, specified, offset, is, negative, or, greater, than, the, number, of, characters, in, <code>, data, </code>, or, if, the, specified, <code>, count, </code>, is, negative.

void  appendData ( const DOMString &arg )

appendData

Append the string to the end of the character data of the node. Upon success, <code> data </code> provides access to the concatenation of <code> data </code> and the <code> DOMString </code> specified.

Parameters:
argThe <code> DOMString </code> to append.

Throws: DOMException, NO_MODIFICATION_ALLOWED_ERR:, Raised, if, this, node, is, readonly.

void  insertData ( const unsigned long offset, const DOMString &arg )

insertData

Insert a string at the specified character offset.

NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

Parameters:
offsetThe character offset at which to insert.
argThe <code> DOMString </code> to insert.

Throws: DOMException, INDEX_SIZE_ERR:, Raised, if, the, specified, offset, is, negative, or, greater, than, the, number, of, characters, in, <code>, data, </code>, .

void  deleteData ( const unsigned long offset, const unsigned long count )

deleteData

Remove a range of characters from the node. Upon success, <code> data </code> and <code> length </code> reflect the change.

NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

Parameters:
offsetThe offset from which to remove characters.
countThe number of characters to delete. If the sum of <code> offset </code> and <code> count </code> exceeds <code> length </code> then all characters from <code> offset </code> to the end of the data are deleted.

Throws: DOMException, INDEX_SIZE_ERR:, Raised, if, the, specified, offset, is, negative, or, greater, than, the, number, of, characters, in, <code>, data, </code>, or, if, the, specified, <code>, count, </code>, is, negative.

void  replaceData ( const unsigned long offset, const unsigned long count, const DOMString &arg )

replaceData

Replace the characters starting at the specified character offset with the specified string.

NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

Parameters:
offsetThe offset from which to start replacing.
countThe number of characters to replace. If the sum of <code> offset </code> and <code> count </code> exceeds <code> length </code> , then all characters to the end of the data are replaced (i.e., the effect is the same as a <code> remove </code> method call with the same range, followed by an <code> append </code> method invocation).
argThe <code> DOMString </code> with which the range must be replaced.

Throws: DOMException, INDEX_SIZE_ERR:, Raised, if, the, specified, offset, is, negative, or, greater, than, the, number, of, characters, in, <code>, data, </code>, or, if, the, specified, <code>, count, </code>, is, negative.

 CharacterData (CharacterDataImpl *i)

CharacterData

[protected]


Generated by: root@daffy.perf.redhat.com on Mon Jul 14 13:28:10 2003, using kdoc 2.0a53.