DOMNodeList.
* Implementations should raise other exceptions under other circumstances.
* For example, implementations should raise an implementation-dependent
* exception if a null argument is passed.
*
Some languages and object systems do not support the concept of * exceptions. For such systems, error conditions may be indicated using * native error reporting mechanisms. For some bindings, for example, * methods may return error codes similar to those listed in the * corresponding method descriptions. *
See also the Document Object Model (DOM) Level 2 Core Specification. * @since DOM Level 1 */ class CDOM_EXPORT DOMException { public: // ----------------------------------------------------------------------- // Constructors // ----------------------------------------------------------------------- /** @name Constructors */ //@{ /** * Default constructor for DOMException. * */ DOMException(); /** * Constructor which takes an error code and a message. * * @param code The error code which indicates the exception * @param message The string containing the error message */ DOMException(short code, const XMLCh *message); /** * Copy constructor. * * @param other The object to be copied. */ DOMException(const DOMException &other); //@} // ----------------------------------------------------------------------- // Destructors // ----------------------------------------------------------------------- /** @name Destructor. */ //@{ /** * Destructor for DOMException. * */ virtual ~DOMException(); //@} public: // ----------------------------------------------------------------------- // Class Types // ----------------------------------------------------------------------- /** @name Public Contants */ //@{ /** * ExceptionCode * *
INDEX_SIZE_ERR:
* If index or size is negative, or greater than the allowed value.
DOMSTRING_SIZE_ERR:
* If the specified range of text does not fit into a DOMString.
HIERARCHY_REQUEST_ERR:
* If any node is inserted somewhere it doesn't belong.
WRONG_DOCUMENT_ERR:
* If a node is used in a different document than the one that created it
* (that doesn't support it).
INVALID_CHARACTER_ERR:
* If an invalid or illegal character is specified, such as in a name. See
* production 2 in the XML specification for the definition of a legal
* character, and production 5 for the definition of a legal name
* character.
NO_DATA_ALLOWED_ERR:
* If data is specified for a node which does not support data.
NO_MODIFICATION_ALLOWED_ERR:
* If an attempt is made to modify an object where modifications are not
* allowed.
NOT_FOUND_ERR:
* If an attempt is made to reference a node in a context where it does
* not exist.
NOT_SUPPORTED_ERR:
* If the implementation does not support the requested type of object or
* operation.
INUSE_ATTRIBUTE_ERR:
* If an attempt is made to add an attribute that is already in use
* elsewhere.
INVALID_STATE_ERR:
* If an attempt is made to use an object that is not, or is no longer,
* usable.
SYNTAX_ERR:
* If an invalid or illegal string is specified.
INVALID_MODIFICATION_ERR:
* If an attempt is made to modify the type of the underlying object.
NAMESPACE_ERR:
* If an attempt is made to create or change an object in a way which is
* incorrect with regard to namespaces.
INVALID_ACCESS_ERR:
* If a parameter or an operation is not supported by the underlying
* object.
*
* The above are since DOM Level 2
* @since DOM Level 2
*
*
VALIDATION_ERR:
* If a call to a method such as insertBefore or
* removeChild would make the Node invalid
* with respect to "partial validity", this exception would be raised
* and the operation would not be done.
*
* The above is since DOM Level 2
* @since DOM Level 3
*/
enum ExceptionCode {
INDEX_SIZE_ERR = 1,
DOMSTRING_SIZE_ERR = 2,
HIERARCHY_REQUEST_ERR = 3,
WRONG_DOCUMENT_ERR = 4,
INVALID_CHARACTER_ERR = 5,
NO_DATA_ALLOWED_ERR = 6,
NO_MODIFICATION_ALLOWED_ERR = 7,
NOT_FOUND_ERR = 8,
NOT_SUPPORTED_ERR = 9,
INUSE_ATTRIBUTE_ERR = 10,
INVALID_STATE_ERR = 11,
SYNTAX_ERR = 12,
INVALID_MODIFICATION_ERR = 13,
NAMESPACE_ERR = 14,
INVALID_ACCESS_ERR = 15,
VALIDATION_ERR = 16
};
//@}
// -----------------------------------------------------------------------
// Class Types
// -----------------------------------------------------------------------
/** @name Public variables */
//@{
/**
* A code value, from the set defined by the ExceptionCode enum,
* indicating the type of error that occured.
*/
ExceptionCode code;
/**
* A string value. Applications may use this field to hold an error
* message. The field value is not set by the DOM implementation,
* meaning that the string will be empty when an exception is first
* thrown.
*/
const XMLCh *msg;
//@}
private:
// -----------------------------------------------------------------------
// Unimplemented constructors and operators
// -----------------------------------------------------------------------
DOMException & operator = (const DOMException &);
};
XERCES_CPP_NAMESPACE_END
#endif