http://xml.apache.org/http://www.apache.org/http://www.w3.org/

Home

Readme
Installation
Build

API Docs
Samples
Programming
Migration
FAQs

Releases
Feedback
Bug-Todo

Download
CVS Repository
Mail Archive

API Docs for SAX and DOM
 

Main Page   Class Hierarchy   Alphabetical List   Compound List   File List   Compound Members   File Members  

DOM_DOMImplementation Class Reference

This class provides a way to query the capabilities of an implementation of the DOM. More...

#include <DOM_DOMImplementation.hpp>

List of all members.

Getter functions

bool hasFeature (const DOMString &feature, const DOMString &version)
 Test if the DOM implementation implements a specific feature. More...

DOM_DOMImplementation& getImplementation ()
 Return a reference to a DOM_Implementation object for this DOM implementation. More...


Public Methods

Constructors and assignment operators
 DOM_DOMImplementation ()
 Construct a DOM_Implementation reference variable, which should be assigned to the return value from DOM_Implementation::getImplementation().

DOM_DOMImplementation& operator= (const DOM_DOMImplementation &other)
 Assignment operator.

Destructor
 ~DOM_DOMImplementation ()
 Destructor. More...

Functions introduced in DOM Level 2.
DOM_DocumentType createDocumentType (const DOMString &qualifiedName, const DOMString &publicId, const DOMString &systemId)
 Creates an empty DOM_DocumentType node. More...

DOM_Document createDocument (const DOMString &namespaceURI, const DOMString &qualifiedName, const DOM_DocumentType &doctype)
 Creates an XML DOM_Document object of the specified type with its document element. More...


Detailed Description

This class provides a way to query the capabilities of an implementation of the DOM.


Constructor & Destructor Documentation

DOM_DOMImplementation::DOM_DOMImplementation ( )
 

Construct a DOM_Implementation reference variable, which should be assigned to the return value from DOM_Implementation::getImplementation().

DOM_DOMImplementation::~DOM_DOMImplementation ( )
 

Destructor.

The object being destroyed is a reference to the DOMImplemenentation, not the underlying DOMImplementation object itself, which is owned by the implementation code.


Member Function Documentation

DOM_Document DOM_DOMImplementation::createDocument ( const DOMString & namespaceURI,
const DOMString & qualifiedName,
const DOM_DocumentType & doctype )
 

Creates an XML DOM_Document object of the specified type with its document element.

"Experimental - subject to change"

Parameters:
namespaceURI   The namespace URI of the document element to create, or null.
qualifiedName   The qualified name of the document element to be created.
doctype   The type of document to be created or null.

When doctype is not null, its Node.ownerDocument attribute is set to the document being created.

Returns:
A new DOM_Document object.
Exceptions:
DOMException   INVALID_CHARACTER_ERR: Raised if the specified qualified name contains an illegal character.
NAMESPACE_ERR: Raised if the qualifiedName is malformed, or if the qualifiedName has a prefix that is "xml" and the namespaceURI is different from "http://www.w3.org/XML/1998/namespace".
WRONG_DOCUMENT_ERR: Raised if doctype has already been used with a different document.

DOM_DocumentType DOM_DOMImplementation::createDocumentType ( const DOMString & qualifiedName,
const DOMString & publicId,
const DOMString & systemId )
 

Creates an empty DOM_DocumentType node.

Entity declarations and notations are not made available. Entity reference expansions and default attribute additions do not occur. It is expected that a future version of the DOM will provide a way for populating a DOM_DocumentType.

"Experimental - subject to change"

Parameters:
qualifiedName   The qualified name of the document type to be created.
publicId   The external subset public identifier.
systemId   The external subset system identifier.
Returns:
A new DOM_DocumentType node with Node.ownerDocument set to null.
Exceptions:
DOMException   INVALID_CHARACTER_ERR: Raised if the specified qualified name contains an illegal character.
NAMESPACE_ERR: Raised if the qualifiedName is malformed.

DOM_DOMImplementation & DOM_DOMImplementation::getImplementation ( ) [static]
 

Return a reference to a DOM_Implementation object for this DOM implementation.

Intended to support applications that may be using DOMs retrieved from several different sources, potentially with different underlying implementations.

bool DOM_DOMImplementation::hasFeature ( const DOMString & feature,
const DOMString & version )
 

Test if the DOM implementation implements a specific feature.

Parameters:
feature   The string of the feature to test (case-insensitive). The legal values are defined throughout this specification. The string must be an XML name (see also Compliance).
version   This is the version number of the package name to test. In Level 1, this is the string "1.0". If the version is not specified, supporting any version of the feature will cause the method to return true.
Returns:
true if the feature is implemented in the specified version, false otherwise.

DOM_DOMImplementation & DOM_DOMImplementation::operator= ( const DOM_DOMImplementation & other )
 

Assignment operator.


The documentation for this class was generated from the following file:


Copyright © 2000 The Apache Software Foundation. All Rights Reserved.