XQuilla/docs/dom3-api/classxercesc_1_1DOMCharacterData.html
2020-02-17 22:23:16 +01:00

441 lines
27 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>XQilla DOM3 API Documentation</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
<link href="tabs.css" rel="stylesheet" type="text/css">
</head><body>
<a style="float:right;" href="http://sourceforge.net/projects/xqilla"><img src="http://sflogo.sourceforge.net/sflogo.php?group_id=152021&amp;type=2" border="0" alt="SourceForge.net Logo" /></a>
<!-- Generated by Doxygen 1.6.1 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
<li><a href="examples.html"><span>Examples</span></a></li>
</ul>
</div>
<div class="tabs">
<ul>
<li><a href="annotated.html"><span>Class&nbsp;List</span></a></li>
<li><a href="classes.html"><span>Class&nbsp;Index</span></a></li>
<li><a href="hierarchy.html"><span>Class&nbsp;Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class&nbsp;Members</span></a></li>
</ul>
</div>
<div class="navpath"><a class="el" href="namespacexercesc.html">xercesc</a>::<a class="el" href="classxercesc_1_1DOMCharacterData.html">DOMCharacterData</a>
</div>
</div>
<div class="contents">
<h1>xercesc::DOMCharacterData Class Reference</h1><!-- doxytag: class="xercesc::DOMCharacterData" --><!-- doxytag: inherits="xercesc::DOMNode" -->
<p>The <code><a class="el" href="classxercesc_1_1DOMCharacterData.html" title="The DOMCharacterData interface extends DOMNode with a set of attributes and methods...">DOMCharacterData</a></code> interface extends <a class="el" href="classxercesc_1_1DOMNode.html" title="The DOMNode interface is the primary datatype for the entire Document Object Model...">DOMNode</a> with a set of attributes and methods for accessing character data in the DOM.
<a href="#_details">More...</a></p>
<p><code>#include &lt;<a class="el" href="DOMCharacterData_8hpp_source.html">DOMCharacterData.hpp</a>&gt;</code></p>
<div class="dynheader">
Inheritance diagram for xercesc::DOMCharacterData:</div>
<div class="dynsection">
<div class="center"><img src="classxercesc_1_1DOMCharacterData__inherit__graph.png" border="0" usemap="#xercesc_1_1DOMCharacterData_inherit__map" alt="Inheritance graph"/></div>
<map name="xercesc_1_1DOMCharacterData_inherit__map" id="xercesc_1_1DOMCharacterData_inherit__map">
<area shape="rect" id="node5" href="classxercesc_1_1DOMComment.html" title="This interface inherits from CharacterData and represents the content of a comment..." alt="" coords="5,160,192,189"/><area shape="rect" id="node7" href="classxercesc_1_1DOMText.html" title="The DOMText interface inherits from DOMCharacterData and represents the textual content..." alt="" coords="216,160,365,189"/><area shape="rect" id="node2" href="classxercesc_1_1DOMNode.html" title="The DOMNode interface is the primary datatype for the entire Document Object Model..." alt="" coords="117,5,272,35"/><area shape="rect" id="node9" href="classxercesc_1_1DOMCDATASection.html" title="CDATA sections are used to escape blocks of text containing characters that would..." alt="" coords="183,237,399,267"/></map>
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<p><a href="classxercesc_1_1DOMCharacterData-members.html">List of all members.</a></p>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td colspan="2"><h2>Public Member Functions</h2></td></tr>
<tr><td colspan="2"><div class="groupHeader">Destructor</div></td></tr>
<tr><td colspan="2"><div class="groupText"><p><a class="anchor" id="amgrp22a8ec108d963f279c6a6a95aa960a57"></a> </p>
<br/><br/></div></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMCharacterData.html#a87c14260fd61df4815a452cde4e936dd">~DOMCharacterData</a> ()</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Destructor. <a href="#a87c14260fd61df4815a452cde4e936dd"></a><br/></td></tr>
<tr><td colspan="2"><div class="groupHeader">Functions introduced in DOM Level 1</div></td></tr>
<tr><td colspan="2"><div class="groupText"><p><a class="anchor" id="amgrp24249042249e54f2e7b060cef8bc9ec0"></a> </p>
<br/><br/></div></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual const XMLCh *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMCharacterData.html#a4d97c4cf5608442f28cfcb1a8883d1d8">getData</a> () const =0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns the character data of the node that implements this interface. <a href="#a4d97c4cf5608442f28cfcb1a8883d1d8"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual XMLSize_t&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMCharacterData.html#a6ae60264096dfdad32a99362b140b1b6">getLength</a> () const =0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns the number of characters that are available through <code>data</code> and the <code>substringData</code> method below. <a href="#a6ae60264096dfdad32a99362b140b1b6"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual const XMLCh *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMCharacterData.html#ae7a0f241e3e126f08efbc76e48a4dc7e">substringData</a> (XMLSize_t offset, XMLSize_t count) const =0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Extracts a range of data from the node. <a href="#ae7a0f241e3e126f08efbc76e48a4dc7e"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMCharacterData.html#ab6f104b28b34c5aea4f7f3a095a55034">appendData</a> (const XMLCh *arg)=0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Append the string to the end of the character data of the node. <a href="#ab6f104b28b34c5aea4f7f3a095a55034"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMCharacterData.html#aae6f592e7aa9655ad29f6671fd2ab2f6">insertData</a> (XMLSize_t offset, const XMLCh *arg)=0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Insert a string at the specified character offset. <a href="#aae6f592e7aa9655ad29f6671fd2ab2f6"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMCharacterData.html#a8548264c0e7dc51a4120af074ff630bc">deleteData</a> (XMLSize_t offset, XMLSize_t count)=0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Remove a range of characters from the node. <a href="#a8548264c0e7dc51a4120af074ff630bc"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMCharacterData.html#a6d618a102fe3245bc89494fe34f1189c">replaceData</a> (XMLSize_t offset, XMLSize_t count, const XMLCh *arg)=0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Replace the characters starting at the specified character offset with the specified string. <a href="#a6d618a102fe3245bc89494fe34f1189c"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMCharacterData.html#ac97dd1ac52e8618d29fde8fa9b7e294c">setData</a> (const XMLCh *data)=0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Sets the character data of the node that implements this interface. <a href="#ac97dd1ac52e8618d29fde8fa9b7e294c"></a><br/></td></tr>
<tr><td colspan="2"><h2>Protected Member Functions</h2></td></tr>
<tr><td colspan="2"><div class="groupHeader">Hidden constructors</div></td></tr>
<tr><td colspan="2"><div class="groupText"><p><a class="anchor" id="amgrp7d629e77fff660516f7d86e8f54695d0"></a> </p>
<br/><br/></div></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMCharacterData.html#a82779b668e65db522db4fb869d97b638">DOMCharacterData</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMCharacterData.html#a6f78323a15eba8db2d1c272d845d4025">DOMCharacterData</a> (const <a class="el" href="classxercesc_1_1DOMCharacterData.html">DOMCharacterData</a> &amp;other)</td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>The <code><a class="el" href="classxercesc_1_1DOMCharacterData.html" title="The DOMCharacterData interface extends DOMNode with a set of attributes and methods...">DOMCharacterData</a></code> interface extends <a class="el" href="classxercesc_1_1DOMNode.html" title="The DOMNode interface is the primary datatype for the entire Document Object Model...">DOMNode</a> with a set of attributes and methods for accessing character data in the DOM. </p>
<p>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><a class="el" href="classxercesc_1_1DOMCharacterData.html" title="The DOMCharacterData interface extends DOMNode with a set of attributes and methods...">DOMCharacterData</a></code>, though <code><a class="el" href="classxercesc_1_1DOMText.html" title="The DOMText interface inherits from DOMCharacterData and represents the textual content...">DOMText</a></code> and others do inherit the interface from it. All <code>offsets</code> in this interface start from <code>0</code>. </p>
<p>As explained in the DOM spec, text strings in the DOM are represented in UTF-16, i.e. as a sequence of 16-bit units. In the following, the term 16-bit units is used whenever necessary to indicate that indexing on <a class="el" href="classxercesc_1_1DOMCharacterData.html" title="The DOMCharacterData interface extends DOMNode with a set of attributes and methods...">DOMCharacterData</a> is done in 16-bit units. </p>
<p>See also the <a href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113">Document Object Model (DOM) Level 2 Core Specification</a>. </p>
<dl class="since"><dt><b>Since:</b></dt><dd>DOM Level 1 </dd></dl>
<hr/><h2>Constructor &amp; Destructor Documentation</h2>
<a class="anchor" id="a82779b668e65db522db4fb869d97b638"></a><!-- doxytag: member="xercesc::DOMCharacterData::DOMCharacterData" ref="a82779b668e65db522db4fb869d97b638" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">xercesc::DOMCharacterData::DOMCharacterData </td>
<td>(</td>
<td class="paramname"></td>
<td>&nbsp;)&nbsp;</td>
<td><code> [inline, protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="a6f78323a15eba8db2d1c272d845d4025"></a><!-- doxytag: member="xercesc::DOMCharacterData::DOMCharacterData" ref="a6f78323a15eba8db2d1c272d845d4025" args="(const DOMCharacterData &amp;other)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">xercesc::DOMCharacterData::DOMCharacterData </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classxercesc_1_1DOMCharacterData.html">DOMCharacterData</a> &amp;&nbsp;</td>
<td class="paramname"> <em>other</em></td>
<td>&nbsp;)&nbsp;</td>
<td><code> [inline, protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="a87c14260fd61df4815a452cde4e936dd"></a><!-- doxytag: member="xercesc::DOMCharacterData::~DOMCharacterData" ref="a87c14260fd61df4815a452cde4e936dd" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual xercesc::DOMCharacterData::~DOMCharacterData </td>
<td>(</td>
<td class="paramname"></td>
<td>&nbsp;)&nbsp;</td>
<td><code> [inline, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Destructor. </p>
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="ab6f104b28b34c5aea4f7f3a095a55034"></a><!-- doxytag: member="xercesc::DOMCharacterData::appendData" ref="ab6f104b28b34c5aea4f7f3a095a55034" args="(const XMLCh *arg)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void xercesc::DOMCharacterData::appendData </td>
<td>(</td>
<td class="paramtype">const XMLCh *&nbsp;</td>
<td class="paramname"> <em>arg</em></td>
<td>&nbsp;)&nbsp;</td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Append the string to the end of the character data of the node. </p>
<p>Upon success, <code>data</code> provides access to the concatenation of <code>data</code> and the <code>XMLCh* String</code> specified. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>arg</em>&nbsp;</td><td>The <code>XMLCh* String</code> to append. </td></tr>
</table>
</dd>
</dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classxercesc_1_1DOMException.html">DOMException</a></em>&nbsp;</td><td>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. </td></tr>
</table>
</dd>
</dl>
<dl class="since"><dt><b>Since:</b></dt><dd>DOM Level 1 </dd></dl>
</div>
</div>
<a class="anchor" id="a8548264c0e7dc51a4120af074ff630bc"></a><!-- doxytag: member="xercesc::DOMCharacterData::deleteData" ref="a8548264c0e7dc51a4120af074ff630bc" args="(XMLSize_t offset, XMLSize_t count)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void xercesc::DOMCharacterData::deleteData </td>
<td>(</td>
<td class="paramtype">XMLSize_t&nbsp;</td>
<td class="paramname"> <em>offset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">XMLSize_t&nbsp;</td>
<td class="paramname"> <em>count</em></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Remove a range of characters from the node. </p>
<p>Upon success, <code>data</code> and <code>length</code> reflect the change. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>offset</em>&nbsp;</td><td>The offset from which to remove characters. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>count</em>&nbsp;</td><td>The 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. </td></tr>
</table>
</dd>
</dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classxercesc_1_1DOMException.html">DOMException</a></em>&nbsp;</td><td>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. <br/>
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. </td></tr>
</table>
</dd>
</dl>
<dl class="since"><dt><b>Since:</b></dt><dd>DOM Level 1 </dd></dl>
</div>
</div>
<a class="anchor" id="a4d97c4cf5608442f28cfcb1a8883d1d8"></a><!-- doxytag: member="xercesc::DOMCharacterData::getData" ref="a4d97c4cf5608442f28cfcb1a8883d1d8" args="() const =0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual const XMLCh* xercesc::DOMCharacterData::getData </td>
<td>(</td>
<td class="paramname"></td>
<td>&nbsp;)&nbsp;</td>
<td> const<code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the character data of the node that implements this interface. </p>
<p>The DOM implementation may not put arbitrary limits on the amount of data that may be stored in a <code><a class="el" href="classxercesc_1_1DOMCharacterData.html" title="The DOMCharacterData interface extends DOMNode with a set of attributes and methods...">DOMCharacterData</a></code> node. However, implementation limits may mean that the entirety of a node's data may not fit into a single <code>XMLCh* String</code>. In such cases, the user may call <code>substringData</code> to retrieve the data in appropriately sized pieces. </p>
<dl><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classxercesc_1_1DOMException.html">DOMException</a></em>&nbsp;</td><td>NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly. </td></tr>
</table>
</dd>
</dl>
<dl class="since"><dt><b>Since:</b></dt><dd>DOM Level 1 </dd></dl>
</div>
</div>
<a class="anchor" id="a6ae60264096dfdad32a99362b140b1b6"></a><!-- doxytag: member="xercesc::DOMCharacterData::getLength" ref="a6ae60264096dfdad32a99362b140b1b6" args="() const =0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual XMLSize_t xercesc::DOMCharacterData::getLength </td>
<td>(</td>
<td class="paramname"></td>
<td>&nbsp;)&nbsp;</td>
<td> const<code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the number of characters that are available through <code>data</code> and the <code>substringData</code> method below. </p>
<p>This may have the value zero, i.e., <code>CharacterData</code> nodes may be empty. </p>
<dl class="since"><dt><b>Since:</b></dt><dd>DOM Level 1 </dd></dl>
</div>
</div>
<a class="anchor" id="aae6f592e7aa9655ad29f6671fd2ab2f6"></a><!-- doxytag: member="xercesc::DOMCharacterData::insertData" ref="aae6f592e7aa9655ad29f6671fd2ab2f6" args="(XMLSize_t offset, const XMLCh *arg)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void xercesc::DOMCharacterData::insertData </td>
<td>(</td>
<td class="paramtype">XMLSize_t&nbsp;</td>
<td class="paramname"> <em>offset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const XMLCh *&nbsp;</td>
<td class="paramname"> <em>arg</em></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Insert a string at the specified character offset. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>offset</em>&nbsp;</td><td>The character offset at which to insert. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>arg</em>&nbsp;</td><td>The <code>XMLCh* String</code> to insert. </td></tr>
</table>
</dd>
</dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classxercesc_1_1DOMException.html">DOMException</a></em>&nbsp;</td><td>INDEX_SIZE_ERR: Raised if the specified offset is negative or greater than the number of characters in <code>data</code>. <br/>
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. </td></tr>
</table>
</dd>
</dl>
<dl class="since"><dt><b>Since:</b></dt><dd>DOM Level 1 </dd></dl>
</div>
</div>
<a class="anchor" id="a6d618a102fe3245bc89494fe34f1189c"></a><!-- doxytag: member="xercesc::DOMCharacterData::replaceData" ref="a6d618a102fe3245bc89494fe34f1189c" args="(XMLSize_t offset, XMLSize_t count, const XMLCh *arg)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void xercesc::DOMCharacterData::replaceData </td>
<td>(</td>
<td class="paramtype">XMLSize_t&nbsp;</td>
<td class="paramname"> <em>offset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">XMLSize_t&nbsp;</td>
<td class="paramname"> <em>count</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const XMLCh *&nbsp;</td>
<td class="paramname"> <em>arg</em></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Replace the characters starting at the specified character offset with the specified string. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>offset</em>&nbsp;</td><td>The offset from which to start replacing. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>count</em>&nbsp;</td><td>The 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). </td></tr>
<tr><td valign="top"></td><td valign="top"><em>arg</em>&nbsp;</td><td>The <code>XMLCh* String</code> with which the range must be replaced. </td></tr>
</table>
</dd>
</dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classxercesc_1_1DOMException.html">DOMException</a></em>&nbsp;</td><td>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. <br/>
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. </td></tr>
</table>
</dd>
</dl>
<dl class="since"><dt><b>Since:</b></dt><dd>DOM Level 1 </dd></dl>
</div>
</div>
<a class="anchor" id="ac97dd1ac52e8618d29fde8fa9b7e294c"></a><!-- doxytag: member="xercesc::DOMCharacterData::setData" ref="ac97dd1ac52e8618d29fde8fa9b7e294c" args="(const XMLCh *data)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void xercesc::DOMCharacterData::setData </td>
<td>(</td>
<td class="paramtype">const XMLCh *&nbsp;</td>
<td class="paramname"> <em>data</em></td>
<td>&nbsp;)&nbsp;</td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets the character data of the node that implements this interface. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>data</em>&nbsp;</td><td>The <code>XMLCh* String</code> to set. </td></tr>
</table>
</dd>
</dl>
<dl class="since"><dt><b>Since:</b></dt><dd>DOM Level 1 </dd></dl>
</div>
</div>
<a class="anchor" id="ae7a0f241e3e126f08efbc76e48a4dc7e"></a><!-- doxytag: member="xercesc::DOMCharacterData::substringData" ref="ae7a0f241e3e126f08efbc76e48a4dc7e" args="(XMLSize_t offset, XMLSize_t count) const =0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual const XMLCh* xercesc::DOMCharacterData::substringData </td>
<td>(</td>
<td class="paramtype">XMLSize_t&nbsp;</td>
<td class="paramname"> <em>offset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">XMLSize_t&nbsp;</td>
<td class="paramname"> <em>count</em></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td> const<code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Extracts a range of data from the node. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>offset</em>&nbsp;</td><td>Start offset of substring to extract. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>count</em>&nbsp;</td><td>The number of characters to extract. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>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. </dd></dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classxercesc_1_1DOMException.html">DOMException</a></em>&nbsp;</td><td>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. </td></tr>
</table>
</dd>
</dl>
<dl class="since"><dt><b>Since:</b></dt><dd>DOM Level 1 </dd></dl>
</div>
</div>
<hr/>The documentation for this class was generated from the following file:<ul>
<li><a class="el" href="DOMCharacterData_8hpp_source.html">DOMCharacterData.hpp</a></li>
</ul>
</div>
<hr size="1"/><address style="text-align: right;"><small>Generated on 18 May 2015 for XQilla DOM Level 3 API by&nbsp;
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.1 </small></address>
</body>
</html>