<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>Class Poco::XML::DOMException</title> <meta http-equiv="content-type" content="text/html; charset=utf-8"/> <meta name="author" content="Applied Informatics Software Engineering GmbH and Contributors"/> <meta name="publisher" content="Applied Informatics Software Engineering GmbH and Contributors"/> <meta name="copyright" content="Copyright (c) 2009, Applied Informatics Software Engineering GmbH and Contributors"/> <meta name="language" content="en"/> <meta name="date" content="2009-11-24"/> <meta name="generator" content="PocoDoc"/> <link rel="stylesheet" href="css/styles.css" type="text/css"/> </head> <body bgcolor="#ffffff" leftmargin="0" topmargin="0"> <div class="header"> <h1 class="namespace"><a href="Poco.XML.html" class="namespace">Poco::XML</a></h1> <h1 class="symbol">class DOMException</h1> </div> <div class="body"> <p> <b>Library:</b> XML<br /> <b>Package:</b> DOM<br /> <b>Header:</b> Poco/DOM/DOMException.h</p> <h2>Description</h2> <div class="description"> <p>DOM operations only raise exceptions in "exceptional" circumstances, i.e., when an operation is impossible to perform (either for logical reasons, because data is lost, or because the implementation has become unstable). In general, DOM methods return specific error values in ordinary processing situations, such as out-of-bound errors when using <a href="Poco.XML.NodeList.html" title="class Poco::XML::NodeList">NodeList</a>. </p> <p>Implementations should raise other exceptions under other circumstances. For example, implementations should raise an implementation-dependent exception if a null argument is passed when null was not expected. </p> </div> <h2>Inheritance</h2> <p><b>Direct Base Classes: </b><a href="Poco.XML.XMLException.html" title="class Poco::XML::XMLException">XMLException</a></p> <p><b>All Base Classes: </b><a href="Poco.Exception.html" title="class Poco::Exception">Poco::Exception</a>, <a href="Poco.RuntimeException.html" title="class Poco::RuntimeException">Poco::RuntimeException</a>, <a href="Poco.XML.XMLException.html" title="class Poco::XML::XMLException">XMLException</a>, std::exception</p> <h2>Member Summary</h2> <p><b>Member Functions: </b><a href="Poco.XML.DOMException.html#17848" title="Poco::XML::DOMException::className()">className</a>, <a href="Poco.XML.DOMException.html#17849" title="Poco::XML::DOMException::clone()">clone</a>, <a href="Poco.XML.DOMException.html#17851" title="Poco::XML::DOMException::code()">code</a>, <a href="Poco.XML.DOMException.html#17852" title="Poco::XML::DOMException::message()">message</a>, <a href="Poco.XML.DOMException.html#17847" title="Poco::XML::DOMException::name()">name</a>, <a href="Poco.XML.DOMException.html#17845" title="Poco::XML::DOMException::operator =()">operator =</a>, <a href="Poco.XML.DOMException.html#17850" title="Poco::XML::DOMException::rethrow()">rethrow</a></p> <p><b>Inherited Functions: </b><a href="Poco.Exception.html#5710" title="Poco::Exception::className()">className</a>, <a href="Poco.Exception.html#5716" title="Poco::Exception::clone()">clone</a>, <a href="Poco.Exception.html#5714" title="Poco::Exception::code()">code</a>, <a href="Poco.Exception.html#5715" title="Poco::Exception::displayText()">displayText</a>, <a href="Poco.Exception.html#5722" title="Poco::Exception::extendedMessage()">extendedMessage</a>, <a href="Poco.Exception.html#5713" title="Poco::Exception::message()">message</a>, <a href="Poco.Exception.html#5709" title="Poco::Exception::name()">name</a>, <a href="Poco.Exception.html#5712" title="Poco::Exception::nested()">nested</a>, <a href="Poco.Exception.html#5707" title="Poco::Exception::operator =()">operator =</a>, <a href="Poco.Exception.html#5717" title="Poco::Exception::rethrow()">rethrow</a>, <a href="Poco.Exception.html#5711" title="Poco::Exception::what()">what</a></p> <h2>Enumerations</h2> <h3><i>Anonymous</i></h3> <div class="description"> <p></p> </div> <p class="decl"><a name="17824">INDEX_SIZE_ERR</a> = 1</p> <div class="description"> <p>index or size is negative or greater than allowed value </p> </div> <p class="decl"><a name="17825">DOMSTRING_SIZE_ERR</a></p> <div class="description"> <p>the specified range of text does not fit into a DOMString (not used) </p> </div> <p class="decl"><a name="17826">HIERARCHY_REQUEST_ERR</a></p> <div class="description"> <p>a node is inserted somewhere it doesn't belong </p> </div> <p class="decl"><a name="17827">WRONG_DOCUMENT_ERR</a></p> <div class="description"> <p>a node is used in a different document than the one that created it </p> </div> <p class="decl"><a name="17828">INVALID_CHARACTER_ERR</a></p> <div class="description"> <p>an invalid character is specified (not used) </p> </div> <p class="decl"><a name="17829">NO_DATA_ALLOWED_ERR</a></p> <div class="description"> <p>data is specified for a node which does not support data </p> </div> <p class="decl"><a name="17830">NO_MODIFICATION_ALLOWED_ERR</a></p> <div class="description"> <p>an attempt is made to modify an object where modifications are not allowed </p> </div> <p class="decl"><a name="17831">NOT_FOUND_ERR</a></p> <div class="description"> <p>an attempt was made to reference a node in a context where it does not exist </p> </div> <p class="decl"><a name="17832">NOT_SUPPORTED_ERR</a></p> <div class="description"> <p>the implementation does not support the type of object requested </p> </div> <p class="decl"><a name="17833">INUSE_ATTRIBUTE_ERR</a></p> <div class="description"> <p>an attempt is made to add an attribute that is already in use elsewhere </p> </div> <p class="decl"><a name="17834">INVALID_STATE_ERR</a></p> <div class="description"> <p>a parameter or an operation is not supported by the underlying object </p> </div> <p class="decl"><a name="17835">SYNTAX_ERR</a></p> <div class="description"> <p>an invalid or illegal string is specified </p> </div> <p class="decl"><a name="17836">INVALID_MODIFICATION_ERR</a></p> <div class="description"> <p>an attempt is made to modify the type of the underlying object </p> </div> <p class="decl"><a name="17837">NAMESPACE_ERR</a></p> <div class="description"> <p>an attempt is made to create or change an object in a way which is incorrect with regard to namespaces </p> </div> <p class="decl"><a name="17838">INVALID_ACCESS_ERR</a></p> <div class="description"> <p>an attempt is made to use an object that is not, or is no longer, usable </p> </div> <p class="decl"><a name="17839">_NUMBER_OF_MESSAGES</a></p> <div class="description"> <p></p> </div> <h2>Constructors</h2> <h3><a name="17840">DOMException</a></h3> <p class="decl"><a href="Poco.XML.DOMException.html" title="class Poco::XML::DOMException">DOMException</a>(<br /> unsigned short code<br />);</p> <div class="description"> <p>Creates a <a href="Poco.XML.DOMException.html" title="class Poco::XML::DOMException">DOMException</a> with the given error code. </p> </div> <h3><a name="17842">DOMException</a></h3> <p class="decl"><a href="Poco.XML.DOMException.html" title="class Poco::XML::DOMException">DOMException</a>(<br /> const <a href="Poco.XML.DOMException.html" title="class Poco::XML::DOMException">DOMException</a> & exc<br />);</p> <div class="description"> <p>Creates a <a href="Poco.XML.DOMException.html" title="class Poco::XML::DOMException">DOMException</a> by copying another one. </p> </div> <h2>Destructor</h2> <h3><a name="17844">~DOMException</a></h3> <p class="decl">~<a href="Poco.XML.DOMException.html" title="class Poco::XML::DOMException">DOMException</a>();</p> <div class="description"> <p>Destroys the <a href="Poco.XML.DOMException.html" title="class Poco::XML::DOMException">DOMException</a>. </p> </div> <h2>Member Functions</h2> <h3><a name="17848">className</a> <img src="images/virtual.gif" alt="virtual" title="virtual" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl">const char * className() const;</p> <div class="description"> <p>Returns the name of the exception class. </p> </div> <div class="description"><p><b>See also:</b> <a href="Poco.XML.XMLException.html#19833" title="Poco::XML::XMLException::className()">Poco::XML::XMLException::className()</a></p></div> <h3><a name="17849">clone</a></h3> <p class="decl"><a href="Poco.Exception.html" title="class Poco::Exception">Poco::Exception</a> * clone() const;</p> <div class="description"> <p>Creates an exact copy of the exception. </p> </div> <h3><a name="17851">code</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl">unsigned short code() const;</p> <div class="description"> <p>Returns the DOM exception code. </p> </div> <h3><a name="17847">name</a> <img src="images/virtual.gif" alt="virtual" title="virtual" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl">const char * name() const;</p> <div class="description"> <p>Returns a static string describing the exception. </p> </div> <div class="description"><p><b>See also:</b> <a href="Poco.XML.XMLException.html#19832" title="Poco::XML::XMLException::name()">Poco::XML::XMLException::name()</a></p></div> <h3><a name="17845">operator =</a></h3> <p class="decl"><a href="Poco.XML.DOMException.html" title="class Poco::XML::DOMException">DOMException</a> & operator = (<br /> const <a href="Poco.XML.DOMException.html" title="class Poco::XML::DOMException">DOMException</a> & exc<br />);</p> <div class="description"> <p></p> </div> <h3><a name="17850">rethrow</a> <img src="images/virtual.gif" alt="virtual" title="virtual" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl">void rethrow() const;</p> <div class="description"> <p>(Re)Throws the exception. </p> </div> <div class="description"><p><b>See also:</b> <a href="Poco.XML.XMLException.html#19835" title="Poco::XML::XMLException::rethrow()">Poco::XML::XMLException::rethrow()</a></p></div> <h3><a name="17852">message</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl">static const std::string & message(<br /> unsigned short code<br />);</p> <div class="description"> <p></p> </div> <p class="footer">POCO C++ Libraries 1.3.6-all<br /> Copyright © 2009, <a href="http://pocoproject.org/" target="_blank">Applied Informatics Software Engineering GmbH and Contributors</a></p> </div> </body> </html>
