/****************************************************************************
**
** Implementation of TQDomDocument and related classes.
**
** Created : 000518
**
** Copyright (C) 1992-2008 Trolltech ASA. All rights reserved.
**
** This file is part of the xml module of the TQt GUI Toolkit.
**
** This file may be used under the terms of the GNU General
** Public License versions 2.0 or 3.0 as published by the Free
** Software Foundation and appearing in the files LICENSE.GPL2
** and LICENSE.GPL3 included in the packaging of this file.
** Alternatively you may (at your option) use any later version
** of the GNU General Public License if such license has been
** publicly approved by Trolltech ASA (or its successors, if any)
** and the KDE Free TQt Foundation.
**
** Please review the following information to ensure GNU General
** Public Licensing requirements will be met:
** http://trolltech.com/products/qt/licenses/licensing/opensource/.
** If you are unsure which license is appropriate for your use, please
** review the following information:
** http://trolltech.com/products/qt/licenses/licensing/licensingoverview
** or contact the sales department at sales@trolltech.com.
**
** This file may be used under the terms of the Q Public License as
** defined by Trolltech ASA and appearing in the file LICENSE.TQPL
** included in the packaging of this file. Licensees holding valid TQt
** Commercial licenses may use this file in accordance with the TQt
** Commercial License Agreement provided with the Software.
**
** This file is provided "AS IS" with NO WARRANTY OF ANY KIND,
** INCLUDING THE WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR
** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted
** herein.
**
**********************************************************************/
#include "ntqdom.h"
#ifndef QT_NO_DOM
#include "ntqxml.h"
#include "ntqptrlist.h"
#include "ntqdict.h"
#include "ntqtextstream.h"
#include "ntqtextcodec.h"
#include "ntqiodevice.h"
#include "ntqregexp.h"
#include "ntqbuffer.h"
/*
### old todo comments -- I don't know if they still apply...
If the document dies, remove all pointers to it from children
which can not be deleted at this time.
If a node dies and has direct children which can not be deleted,
then remove the pointer to the parent.
createElement and friends create double reference counts.
*/
/*
Reference counting:
Some simple rules:
1) If an intern object returns a pointer to another intern object
then the reference count of the returned object is not increased.
2) If an extern object is created and gets a pointer to some intern
object, then the extern object increases the intern objects reference count.
3) If an extern object is deleted, then it decreases the reference count
on its associated intern object and deletes it if nobody else hold references
on the intern object.
*/
/*
Helper to split a qualified name in the prefix and local name.
*/
static void qt_split_namespace( TQString& prefix, TQString& name, const TQString& qName, bool hasURI )
{
int i = qName.find( ':' );
if ( i == -1 ) {
if ( hasURI )
prefix = "";
else
prefix = TQString::null;
name = qName;
} else {
prefix = qName.left( i );
name = qName.mid( i + 1 );
}
}
/*
Counter for the TQDomNodeListPrivate timestamps.
*/
static volatile long qt_nodeListTime = 0;
/**************************************************************
*
* Private class declerations
*
**************************************************************/
class TQDomImplementationPrivate : public TQShared
{
public:
TQDomImplementationPrivate();
~TQDomImplementationPrivate();
TQDomImplementationPrivate* clone();
};
class TQDomNodePrivate : public TQShared
{
public:
TQDomNodePrivate( TQDomDocumentPrivate*, TQDomNodePrivate* parent = 0 );
TQDomNodePrivate( TQDomNodePrivate* n, bool deep );
virtual ~TQDomNodePrivate();
TQString nodeName() const { return name; }
TQString nodeValue() const { return value; }
virtual void setNodeValue( const TQString& v ) { value = v; }
TQDomDocumentPrivate* ownerDocument();
void setOwnerDocument( TQDomDocumentPrivate* doc );
virtual TQDomNamedNodeMapPrivate* attributes();
virtual bool hasAttributes() { return FALSE; }
virtual TQDomNodePrivate* insertBefore( TQDomNodePrivate* newChild, TQDomNodePrivate* refChild );
virtual TQDomNodePrivate* insertAfter( TQDomNodePrivate* newChild, TQDomNodePrivate* refChild );
virtual TQDomNodePrivate* replaceChild( TQDomNodePrivate* newChild, TQDomNodePrivate* oldChild );
virtual TQDomNodePrivate* removeChild( TQDomNodePrivate* oldChild );
virtual TQDomNodePrivate* appendChild( TQDomNodePrivate* newChild );
TQDomNodePrivate* namedItem( const TQString& name );
virtual TQDomNodePrivate* cloneNode( bool deep = TRUE );
virtual void normalize();
virtual void clear();
TQDomNodePrivate* parent() { return hasParent ? ownerNode : 0; }
void setParent( TQDomNodePrivate *p ) { ownerNode = p; hasParent = TRUE; }
void setNoParent() {
ownerNode = hasParent ? (TQDomNodePrivate*)ownerDocument() : 0;
hasParent = FALSE;
}
// Dynamic cast
virtual bool isAttr() { return FALSE; }
virtual bool isCDATASection() { return FALSE; }
virtual bool isDocumentFragment() { return FALSE; }
virtual bool isDocument() { return FALSE; }
virtual bool isDocumentType() { return FALSE; }
virtual bool isElement() { return FALSE; }
virtual bool isEntityReference() { return FALSE; }
virtual bool isText() { return FALSE; }
virtual bool isEntity() { return FALSE; }
virtual bool isNotation() { return FALSE; }
virtual bool isProcessingInstruction() { return FALSE; }
virtual bool isCharacterData() { return FALSE; }
virtual bool isComment() { return FALSE; }
virtual TQDomNode::NodeType nodeType() const { return TQDomNode::BaseNode; }
virtual void save( TQTextStream&, int, int ) const;
// Variables
TQDomNodePrivate* prev;
TQDomNodePrivate* next;
TQDomNodePrivate* ownerNode; // either the node's parent or the node's owner document
TQDomNodePrivate* first;
TQDomNodePrivate* last;
TQString name; // this is the local name if prefix != null
TQString value;
TQString prefix; // set this only for ElementNode and AttributeNode
TQString namespaceURI; // set this only for ElementNode and AttributeNode
bool createdWithDom1Interface;
bool hasParent;
};
class TQDomNodeListPrivate : public TQShared
{
public:
TQDomNodeListPrivate( TQDomNodePrivate* );
TQDomNodeListPrivate( TQDomNodePrivate*, const TQString& );
TQDomNodeListPrivate( TQDomNodePrivate*, const TQString&, const TQString& );
virtual ~TQDomNodeListPrivate();
virtual bool operator== ( const TQDomNodeListPrivate& ) const;
virtual bool operator!= ( const TQDomNodeListPrivate& ) const;
void createList();
virtual TQDomNodePrivate* item( int index );
virtual uint length() const;
TQDomNodePrivate* node_impl;
TQString tagname;
TQString nsURI;
TQPtrList<TQDomNodePrivate> list;
long timestamp;
};
class TQDomNamedNodeMapPrivate : public TQShared
{
public:
TQDomNamedNodeMapPrivate( TQDomNodePrivate* );
~TQDomNamedNodeMapPrivate();
TQDomNodePrivate* namedItem( const TQString& name ) const;
TQDomNodePrivate* namedItemNS( const TQString& nsURI, const TQString& localName ) const;
TQDomNodePrivate* setNamedItem( TQDomNodePrivate* arg );
TQDomNodePrivate* setNamedItemNS( TQDomNodePrivate* arg );
TQDomNodePrivate* removeNamedItem( const TQString& name );
TQDomNodePrivate* item( int index ) const;
uint length() const;
bool contains( const TQString& name ) const;
bool containsNS( const TQString& nsURI, const TQString & localName ) const;
/**
* Remove all children from the map.
*/
void clearMap();
bool isReadOnly() { return readonly; }
void setReadOnly( bool r ) { readonly = r; }
bool isAppendToParent() { return appendToParent; }
/**
* If TRUE, then the node will redirect insert/remove calls
* to its parent by calling TQDomNodePrivate::appendChild or removeChild.
* In addition the map wont increase or decrease the reference count
* of the nodes it contains.
*
* By default this value is FALSE and the map will handle reference counting
* by itself.
*/
void setAppendToParent( bool b ) { appendToParent = b; }
/**
* Creates a copy of the map. It is a deep copy
* that means that all children are cloned.
*/
TQDomNamedNodeMapPrivate* clone( TQDomNodePrivate* parent );
// Variables
TQDict<TQDomNodePrivate> map;
TQDomNodePrivate* parent;
bool readonly;
bool appendToParent;
};
class TQDomDocumentTypePrivate : public TQDomNodePrivate
{
public:
TQDomDocumentTypePrivate( TQDomDocumentPrivate*, TQDomNodePrivate* parent = 0 );
TQDomDocumentTypePrivate( TQDomDocumentTypePrivate* n, bool deep );
~TQDomDocumentTypePrivate();
void init();
// Reimplemented from TQDomNodePrivate
TQDomNodePrivate* cloneNode( bool deep = TRUE );
TQDomNodePrivate* insertBefore( TQDomNodePrivate* newChild, TQDomNodePrivate* refChild );
TQDomNodePrivate* insertAfter( TQDomNodePrivate* newChild, TQDomNodePrivate* refChild );
TQDomNodePrivate* replaceChild( TQDomNodePrivate* newChild, TQDomNodePrivate* oldChild );
TQDomNodePrivate* removeChild( TQDomNodePrivate* oldChild );
TQDomNodePrivate* appendChild( TQDomNodePrivate* newChild );
bool isDocumentType() { return TRUE; }
TQDomNode::NodeType nodeType() const { return TQDomNode::DocumentTypeNode; }
void save( TQTextStream& s, int, int ) const;
// Variables
TQDomNamedNodeMapPrivate* entities;
TQDomNamedNodeMapPrivate* notations;
TQString publicId;
TQString systemId;
TQString internalSubset;
};
class TQDomDocumentFragmentPrivate : public TQDomNodePrivate
{
public:
TQDomDocumentFragmentPrivate( TQDomDocumentPrivate*, TQDomNodePrivate* parent = 0 );
TQDomDocumentFragmentPrivate( TQDomNodePrivate* n, bool deep );
~TQDomDocumentFragmentPrivate();
// Reimplemented from TQDomNodePrivate
TQDomNodePrivate* cloneNode( bool deep = TRUE );
bool isDocumentFragment() { return TRUE; }
TQDomNode::NodeType nodeType() const { return TQDomNode::DocumentFragmentNode; }
};
class TQDomCharacterDataPrivate : public TQDomNodePrivate
{
public:
TQDomCharacterDataPrivate( TQDomDocumentPrivate*, TQDomNodePrivate* parent, const TQString& data );
TQDomCharacterDataPrivate( TQDomCharacterDataPrivate* n, bool deep );
~TQDomCharacterDataPrivate();
uint dataLength() const;
TQString substringData( unsigned long offset, unsigned long count ) const;
void appendData( const TQString& arg );
void insertData( unsigned long offset, const TQString& arg );
void deleteData( unsigned long offset, unsigned long count );
void replaceData( unsigned long offset, unsigned long count, const TQString& arg );
// Reimplemented from TQDomNodePrivate
bool isCharacterData() { return TRUE; }
TQDomNode::NodeType nodeType() const { return TQDomNode::CharacterDataNode; }
TQDomNodePrivate* cloneNode( bool deep = TRUE );
};
class TQDomTextPrivate : public TQDomCharacterDataPrivate
{
public:
TQDomTextPrivate( TQDomDocumentPrivate*, TQDomNodePrivate* parent, const TQString& value );
TQDomTextPrivate( TQDomTextPrivate* n, bool deep );
~TQDomTextPrivate();
TQDomTextPrivate* splitText( int offset );
// Reimplemented from TQDomNodePrivate
TQDomNodePrivate* cloneNode( bool deep = TRUE );
bool isText() { return TRUE; }
TQDomNode::NodeType nodeType() const { return TQDomNode::TextNode; }
void save( TQTextStream& s, int, int ) const;
};
class TQDomAttrPrivate : public TQDomNodePrivate
{
public:
TQDomAttrPrivate( TQDomDocumentPrivate*, TQDomNodePrivate*, const TQString& name );
TQDomAttrPrivate( TQDomDocumentPrivate*, TQDomNodePrivate*, const TQString& nsURI, const TQString& qName );
TQDomAttrPrivate( TQDomAttrPrivate* n, bool deep );
~TQDomAttrPrivate();
bool specified() const;
// Reimplemented from TQDomNodePrivate
void setNodeValue( const TQString& v );
TQDomNodePrivate* cloneNode( bool deep = TRUE );
bool isAttr() { return TRUE; }
TQDomNode::NodeType nodeType() const { return TQDomNode::AttributeNode; }
void save( TQTextStream& s, int, int ) const;
// Variables
bool m_specified;
};
class TQDomElementPrivate : public TQDomNodePrivate
{
public:
TQDomElementPrivate( TQDomDocumentPrivate*, TQDomNodePrivate* parent, const TQString& name );
TQDomElementPrivate( TQDomDocumentPrivate*, TQDomNodePrivate* parent, const TQString& nsURI, const TQString& qName );
TQDomElementPrivate( TQDomElementPrivate* n, bool deep );
~TQDomElementPrivate();
TQString attribute( const TQString& name, const TQString& defValue ) const;
TQString attributeNS( const TQString& nsURI, const TQString& localName, const TQString& defValue ) const;
void setAttribute( const TQString& name, const TQString& value );
void setAttributeNS( const TQString& nsURI, const TQString& qName, const TQString& newValue );
void removeAttribute( const TQString& name );
TQDomAttrPrivate* attributeNode( const TQString& name);
TQDomAttrPrivate* attributeNodeNS( const TQString& nsURI, const TQString& localName );
TQDomAttrPrivate* setAttributeNode( TQDomAttrPrivate* newAttr );
TQDomAttrPrivate* setAttributeNodeNS( TQDomAttrPrivate* newAttr );
TQDomAttrPrivate* removeAttributeNode( TQDomAttrPrivate* oldAttr );
bool hasAttribute( const TQString& name );
bool hasAttributeNS( const TQString& nsURI, const TQString& localName );
TQString text();
// Reimplemented from TQDomNodePrivate
TQDomNamedNodeMapPrivate* attributes() { return m_attr; }
bool hasAttributes() { return ( m_attr->length() > 0 ); }
bool isElement() { return TRUE; }
TQDomNode::NodeType nodeType() const { return TQDomNode::ElementNode; }
TQDomNodePrivate* cloneNode( bool deep = TRUE );
void save( TQTextStream& s, int, int ) const;
// Variables
TQDomNamedNodeMapPrivate* m_attr;
};
class TQDomCommentPrivate : public TQDomCharacterDataPrivate
{
public:
TQDomCommentPrivate( TQDomDocumentPrivate*, TQDomNodePrivate* parent, const TQString& value );
TQDomCommentPrivate( TQDomCommentPrivate* n, bool deep );
~TQDomCommentPrivate();
// Reimplemented from TQDomNodePrivate
TQDomNodePrivate* cloneNode( bool deep = TRUE );
bool isComment() { return TRUE; }
TQDomNode::NodeType nodeType() const { return TQDomNode::CommentNode; }
void save( TQTextStream& s, int, int ) const;
};
class TQDomCDATASectionPrivate : public TQDomTextPrivate
{
public:
TQDomCDATASectionPrivate( TQDomDocumentPrivate*, TQDomNodePrivate* parent, const TQString& value );
TQDomCDATASectionPrivate( TQDomCDATASectionPrivate* n, bool deep );
~TQDomCDATASectionPrivate();
// Reimplemented from TQDomNodePrivate
TQDomNodePrivate* cloneNode( bool deep = TRUE );
bool isCDATASection() { return TRUE; }
TQDomNode::NodeType nodeType() const { return TQDomNode::CDATASectionNode; }
void save( TQTextStream& s, int, int ) const;
};
class TQDomNotationPrivate : public TQDomNodePrivate
{
public:
TQDomNotationPrivate( TQDomDocumentPrivate*, TQDomNodePrivate* parent, const TQString& name,
const TQString& pub, const TQString& sys );
TQDomNotationPrivate( TQDomNotationPrivate* n, bool deep );
~TQDomNotationPrivate();
// Reimplemented from TQDomNodePrivate
TQDomNodePrivate* cloneNode( bool deep = TRUE );
bool isNotation() { return TRUE; }
TQDomNode::NodeType nodeType() const { return TQDomNode::NotationNode; }
void save( TQTextStream& s, int, int ) const;
// Variables
TQString m_sys;
TQString m_pub;
};
class TQDomEntityPrivate : public TQDomNodePrivate
{
public:
TQDomEntityPrivate( TQDomDocumentPrivate*, TQDomNodePrivate* parent, const TQString& name,
const TQString& pub, const TQString& sys, const TQString& notation );
TQDomEntityPrivate( TQDomEntityPrivate* n, bool deep );
~TQDomEntityPrivate();
// Reimplemented from TQDomNodePrivate
TQDomNodePrivate* cloneNode( bool deep = TRUE );
bool isEntity() { return TRUE; }
TQDomNode::NodeType nodeType() const { return TQDomNode::EntityNode; }
void save( TQTextStream& s, int, int ) const;
// Variables
TQString m_sys;
TQString m_pub;
TQString m_notationName;
};
class TQDomEntityReferencePrivate : public TQDomNodePrivate
{
public:
TQDomEntityReferencePrivate( TQDomDocumentPrivate*, TQDomNodePrivate* parent, const TQString& name );
TQDomEntityReferencePrivate( TQDomNodePrivate* n, bool deep );
~TQDomEntityReferencePrivate();
// Reimplemented from TQDomNodePrivate
TQDomNodePrivate* cloneNode( bool deep = TRUE );
bool isEntityReference() { return TRUE; }
TQDomNode::NodeType nodeType() const { return TQDomNode::EntityReferenceNode; }
void save( TQTextStream& s, int, int ) const;
};
class TQDomProcessingInstructionPrivate : public TQDomNodePrivate
{
public:
TQDomProcessingInstructionPrivate( TQDomDocumentPrivate*, TQDomNodePrivate* parent, const TQString& target,
const TQString& data);
TQDomProcessingInstructionPrivate( TQDomProcessingInstructionPrivate* n, bool deep );
~TQDomProcessingInstructionPrivate();
// Reimplemented from TQDomNodePrivate
TQDomNodePrivate* cloneNode( bool deep = TRUE );
bool isProcessingInstruction() { return TRUE; }
TQDomNode::NodeType nodeType() const { return TQDomNode::ProcessingInstructionNode; }
void save( TQTextStream& s, int, int ) const;
};
class TQDomDocumentPrivate : public TQDomNodePrivate
{
public:
TQDomDocumentPrivate();
TQDomDocumentPrivate( const TQString& name );
TQDomDocumentPrivate( TQDomDocumentTypePrivate* dt );
TQDomDocumentPrivate( TQDomDocumentPrivate* n, bool deep );
~TQDomDocumentPrivate();
bool setContent( TQXmlInputSource *source, bool namespaceProcessing, TQString *errorMsg, int *errorLine, int *errorColumn );
bool setContent( TQXmlInputSource *source, TQXmlReader *reader, TQString *errorMsg, int *errorLine, int *errorColumn );
// Attributes
TQDomDocumentTypePrivate* doctype() { return type; };
TQDomImplementationPrivate* implementation() { return impl; };
TQDomElementPrivate* documentElement();
// Factories
TQDomElementPrivate* createElement( const TQString& tagName );
TQDomElementPrivate* createElementNS( const TQString& nsURI, const TQString& qName );
TQDomDocumentFragmentPrivate* createDocumentFragment();
TQDomTextPrivate* createTextNode( const TQString& data );
TQDomCommentPrivate* createComment( const TQString& data );
TQDomCDATASectionPrivate* createCDATASection( const TQString& data );
TQDomProcessingInstructionPrivate* createProcessingInstruction( const TQString& target, const TQString& data );
TQDomAttrPrivate* createAttribute( const TQString& name );
TQDomAttrPrivate* createAttributeNS( const TQString& nsURI, const TQString& qName );
TQDomEntityReferencePrivate* createEntityReference( const TQString& name );
TQDomNodePrivate* importNode( const TQDomNodePrivate* importedNode, bool deep );
// Reimplemented from TQDomNodePrivate
TQDomNodePrivate* cloneNode( bool deep = TRUE );
bool isDocument() { return TRUE; }
TQDomNode::NodeType nodeType() const { return TQDomNode::DocumentNode; }
void clear();
void save( TQTextStream&, int, int ) const;
// Variables
TQDomImplementationPrivate* impl;
TQDomDocumentTypePrivate* type;
};
/**************************************************************
*
* TQDomHandler
*
**************************************************************/
class TQDomHandler : public TQXmlDefaultHandler
{
public:
TQDomHandler( TQDomDocumentPrivate* d, bool namespaceProcessing );
~TQDomHandler();
// content handler
bool endDocument();
bool startElement( const TQString& nsURI, const TQString& localName, const TQString& qName, const TQXmlAttributes& atts );
bool endElement( const TQString& nsURI, const TQString& localName, const TQString& qName );
bool characters( const TQString& ch );
bool processingInstruction( const TQString& target, const TQString& data );
bool skippedEntity( const TQString& name );
// error handler
bool fatalError( const TQXmlParseException& exception );
// lexical handler
bool startCDATA();
bool endCDATA();
bool startEntity( const TQString & );
bool endEntity( const TQString & );
bool startDTD( const TQString& name, const TQString& publicId, const TQString& systemId );
bool comment( const TQString& ch );
// decl handler
bool externalEntityDecl( const TQString &name, const TQString &publicId, const TQString &systemId ) ;
// DTD handler
bool notationDecl( const TQString & name, const TQString & publicId, const TQString & systemId );
bool unparsedEntityDecl( const TQString &name, const TQString &publicId, const TQString &systemId, const TQString ¬ationName ) ;
TQString errorMsg;
int errorLine;
int errorColumn;
private:
TQDomDocumentPrivate *doc;
TQDomNodePrivate *node;
TQString entityName;
bool cdata;
bool nsProcessing;
};
/**************************************************************
*
* TQDomImplementationPrivate
*
**************************************************************/
TQDomImplementationPrivate::TQDomImplementationPrivate()
{
}
TQDomImplementationPrivate::~TQDomImplementationPrivate()
{
}
TQDomImplementationPrivate* TQDomImplementationPrivate::clone()
{
TQDomImplementationPrivate* p = new TQDomImplementationPrivate;
// We are not interested in this node
p->deref();
return p;
}
/**************************************************************
*
* TQDomImplementation
*
**************************************************************/
/*!
\class TQDomImplementation ntqdom.h
\reentrant
\brief The TQDomImplementation class provides information about the
features of the DOM implementation.
\if defined(commercial)
It is part of the <a href="commercialeditions.html">TQt Enterprise Edition</a>.
\endif
\module XML
\ingroup xml-tools
This class describes the features that are supported by the DOM
implementation. Currently the XML subset of DOM Level 1 and DOM
Level 2 Core are supported.
Normally you will use the function TQDomDocument::implementation()
to get the implementation object.
You can create a new document type with createDocumentType() and a
new document with createDocument().
For further information about the Document Object Model see \link
http://www.w3.org/TR/REC-DOM-Level-1/\endlink and \link
http://www.w3.org/TR/DOM-Level-2-Core/\endlink. For a more general
introduction of the DOM implementation see the TQDomDocument
documentation.
\sa hasFeature()
*/
/*!
Constructs a TQDomImplementation object.
*/
TQDomImplementation::TQDomImplementation()
{
impl = 0;
}
/*!
Constructs a copy of \a x.
*/
TQDomImplementation::TQDomImplementation( const TQDomImplementation& x )
{
impl = x.impl;
if ( impl )
impl->ref();
}
TQDomImplementation::TQDomImplementation( TQDomImplementationPrivate* p )
{
// We want to be co-owners, so increase the reference count
impl = p;
if (impl)
impl->ref();
}
/*!
Assigns \a x to this DOM implementation.
*/
TQDomImplementation& TQDomImplementation::operator= ( const TQDomImplementation& x )
{
if ( x.impl )
x.impl->ref(); // avoid x=x
if ( impl && impl->deref() )
delete impl;
impl = x.impl;
return *this;
}
/*!
Returns TRUE if \a x and this DOM implementation object were
created from the same TQDomDocument; otherwise returns FALSE.
*/
bool TQDomImplementation::operator==( const TQDomImplementation& x ) const
{
return ( impl == x.impl );
}
/*!
Returns TRUE if \a x and this DOM implementation object were
created from different TQDomDocuments; otherwise returns FALSE.
*/
bool TQDomImplementation::operator!=( const TQDomImplementation& x ) const
{
return ( impl != x.impl );
}
/*!
Destroys the object and frees its resources.
*/
TQDomImplementation::~TQDomImplementation()
{
if ( impl && impl->deref() )
delete impl;
}
/*!
The function returns TRUE if TQDom implements the requested \a
version of a \a feature; otherwise returns FALSE.
The currently supported features and their versions:
\table
\header \i Feature \i Version
\row \i XML \i 1.0
\endtable
*/
bool TQDomImplementation::hasFeature( const TQString& feature, const TQString& version )
{
if ( feature == "XML" ) {
if ( version.isEmpty() || version == "1.0" ) {
return TRUE;
}
}
// ### add DOM level 2 features
return FALSE;
}
/*!
Creates a document type node for the name \a qName.
\a publicId specifies the public identifier of the external
subset. If you specify TQString::null as the \a publicId, this
means that the document type has no public identifier.
\a systemId specifies the system identifier of the external
subset. If you specify TQString::null as the \a systemId, this
means that the document type has no system identifier.
Since you cannot have a public identifier without a system
identifier, the public identifier is set to TQString::null if there
is no system identifier.
DOM level 2 does not support any other document type declaration
features.
The only way you can use a document type that was created this
way, is in combination with the createDocument() function to
create a TQDomDocument with this document type.
\sa createDocument();
*/
TQDomDocumentType TQDomImplementation::createDocumentType( const TQString& qName, const TQString& publicId, const TQString& systemId )
{
TQDomDocumentTypePrivate *dt = new TQDomDocumentTypePrivate( 0 );
dt->name = qName;
if ( systemId.isNull() ) {
dt->publicId = TQString::null;
dt->systemId = TQString::null;
} else {
dt->publicId = publicId;
dt->systemId = systemId;
}
return TQDomDocumentType( dt );
}
/*!
Creates a DOM document with the document type \a doctype. This
function also adds a root element node with the qualified name \a
qName and the namespace URI \a nsURI.
*/
TQDomDocument TQDomImplementation::createDocument( const TQString& nsURI, const TQString& qName, const TQDomDocumentType& doctype )
{
TQDomDocument doc( doctype );
TQDomElement root = doc.createElementNS( nsURI, qName );
doc.appendChild( root );
return doc;
}
/*!
Returns FALSE if the object was created by
TQDomDocument::implementation(); otherwise returns TRUE.
*/
bool TQDomImplementation::isNull()
{
return ( impl == 0 );
}
/**************************************************************
*
* TQDomNodeListPrivate
*
**************************************************************/
TQDomNodeListPrivate::TQDomNodeListPrivate( TQDomNodePrivate* n_impl )
{
node_impl = n_impl;
if ( node_impl )
node_impl->ref();
timestamp = -1;
}
TQDomNodeListPrivate::TQDomNodeListPrivate( TQDomNodePrivate* n_impl, const TQString& name )
{
node_impl = n_impl;
if ( node_impl )
node_impl->ref();
tagname = name;
timestamp = -1;
}
TQDomNodeListPrivate::TQDomNodeListPrivate( TQDomNodePrivate* n_impl, const TQString& _nsURI, const TQString& localName )
{
node_impl = n_impl;
if ( node_impl )
node_impl->ref();
tagname = localName;
nsURI = _nsURI;
timestamp = -1;
}
TQDomNodeListPrivate::~TQDomNodeListPrivate()
{
if ( node_impl && node_impl->deref() )
delete node_impl;
}
bool TQDomNodeListPrivate::operator== ( const TQDomNodeListPrivate& other ) const
{
return ( node_impl == other.node_impl ) && ( tagname == other.tagname ) ;
}
bool TQDomNodeListPrivate::operator!= ( const TQDomNodeListPrivate& other ) const
{
return ( node_impl != other.node_impl ) || ( tagname != other.tagname ) ;
}
void TQDomNodeListPrivate::createList()
{
if ( !node_impl )
return;
timestamp = qt_nodeListTime;
TQDomNodePrivate* p = node_impl->first;
list.clear();
if ( tagname.isNull() ) {
while ( p ) {
list.append( p );
p = p->next;
}
} else if ( nsURI.isNull() ) {
while ( p && p != node_impl ) {
if ( p->isElement() && p->nodeName() == tagname ) {
list.append( p );
}
if ( p->first )
p = p->first;
else if ( p->next )
p = p->next;
else {
p = p->parent();
while ( p && p != node_impl && !p->next )
p = p->parent();
if ( p && p != node_impl )
p = p->next;
}
}
} else {
while ( p && p != node_impl ) {
if ( p->isElement() && p->name==tagname && p->namespaceURI==nsURI ) {
list.append( p );
}
if ( p->first )
p = p->first;
else if ( p->next )
p = p->next;
else {
p = p->parent();
while ( p && p != node_impl && !p->next )
p = p->parent();
if ( p && p != node_impl )
p = p->next;
}
}
}
}
TQDomNodePrivate* TQDomNodeListPrivate::item( int index )
{
if ( !node_impl )
return 0;
if ( timestamp < qt_nodeListTime )
createList();
return list.at( index );
}
uint TQDomNodeListPrivate::length() const
{
if ( !node_impl )
return 0;
if ( timestamp < qt_nodeListTime ) {
TQDomNodeListPrivate *that = (TQDomNodeListPrivate*)this;
that->createList();
}
return list.count();
}
/**************************************************************
*
* TQDomNodeList
*
**************************************************************/
/*!
\class TQDomNodeList ntqdom.h
\reentrant
\brief The TQDomNodeList class is a list of TQDomNode objects.
\if defined(commercial)
It is part of the <a href="commercialeditions.html">TQt Enterprise Edition</a>.
\endif
\module XML
\ingroup xml-tools
Lists can be obtained by TQDomDocument::elementsByTagName() and
TQDomNode::childNodes(). The Document Object Model (DOM) requires
these lists to be "live": whenever you change the underlying
document, the contents of the list will get updated.
You can get a particular node from the list with item(). The
number of items in the list is returned by count() (and by
length()).
For further information about the Document Object Model see \link
http://www.w3.org/TR/REC-DOM-Level-1/\endlink and \link
http://www.w3.org/TR/DOM-Level-2-Core/\endlink. For a more general
introduction of the DOM implementation see the TQDomDocument
documentation.
\sa TQDomNode::childNodes() TQDomDocument::elementsByTagName()
*/
/*!
Creates an empty node list.
*/
TQDomNodeList::TQDomNodeList()
{
impl = 0;
}
TQDomNodeList::TQDomNodeList( TQDomNodeListPrivate* p )
{
impl = p;
}
/*!
Constructs a copy of \a n.
*/
TQDomNodeList::TQDomNodeList( const TQDomNodeList& n )
{
impl = n.impl;
if ( impl )
impl->ref();
}
/*!
Assigns \a n to this node list.
*/
TQDomNodeList& TQDomNodeList::operator= ( const TQDomNodeList& n )
{
if ( n.impl )
n.impl->ref();
if ( impl && impl->deref() )
delete impl;
impl = n.impl;
return *this;
}
/*!
Returns TRUE if the node list \a n and this node list are equal;
otherwise returns FALSE.
*/
bool TQDomNodeList::operator== ( const TQDomNodeList& n ) const
{
if ( impl == n.impl )
return TRUE;
if ( !impl || !n.impl )
return FALSE;
return (*impl == *n.impl);
}
/*!
Returns TRUE the node list \a n and this node list are not equal;
otherwise returns FALSE.
*/
bool TQDomNodeList::operator!= ( const TQDomNodeList& n ) const
{
return !operator==(n);
}
/*!
Destroys the object and frees its resources.
*/
TQDomNodeList::~TQDomNodeList()
{
if ( impl && impl->deref() )
delete impl;
}
/*!
Returns the node at position \a index.
If \a index is negative or if \a index >= length() then a null
node is returned (i.e. a node for which TQDomNode::isNull() returns
TRUE).
\sa count()
*/
TQDomNode TQDomNodeList::item( int index ) const
{
if ( !impl )
return TQDomNode();
return TQDomNode( impl->item( index ) );
}
/*!
Returns the number of nodes in the list.
This function is the same as count().
*/
uint TQDomNodeList::length() const
{
if ( !impl )
return 0;
return impl->length();
}
/*!
\fn uint TQDomNodeList::count() const
Returns the number of nodes in the list.
This function is the same as length().
*/
/**************************************************************
*
* TQDomNodePrivate
*
**************************************************************/
inline void TQDomNodePrivate::setOwnerDocument( TQDomDocumentPrivate* doc )
{
ownerNode = doc;
hasParent = FALSE;
}
TQDomNodePrivate::TQDomNodePrivate( TQDomDocumentPrivate* doc, TQDomNodePrivate *par )
{
if ( par )
setParent( par );
else
setOwnerDocument( doc );
prev = 0;
next = 0;
first = 0;
last = 0;
createdWithDom1Interface = TRUE;
}
TQDomNodePrivate::TQDomNodePrivate( TQDomNodePrivate* n, bool deep )
{
setOwnerDocument( n->ownerDocument() );
prev = 0;
next = 0;
first = 0;
last = 0;
name = n->name;
value = n->value;
prefix = n->prefix;
namespaceURI = n->namespaceURI;
createdWithDom1Interface = n->createdWithDom1Interface;
if ( !deep )
return;
for ( TQDomNodePrivate* x = n->first; x; x = x->next )
appendChild( x->cloneNode( TRUE ) );
}
TQDomNodePrivate::~TQDomNodePrivate()
{
TQDomNodePrivate* p = first;
TQDomNodePrivate* n;
while ( p ) {
n = p->next;
if ( p->deref() )
delete p;
else
p->setNoParent();
p = n;
}
first = 0;
last = 0;
}
void TQDomNodePrivate::clear()
{
TQDomNodePrivate* p = first;
TQDomNodePrivate* n;
while ( p ) {
n = p->next;
if ( p->deref() )
delete p;
p = n;
}
first = 0;
last = 0;
}
TQDomNodePrivate* TQDomNodePrivate::namedItem( const TQString& n )
{
TQDomNodePrivate* p = first;
while ( p ) {
if ( p->nodeName() == n )
return p;
p = p->next;
}
return 0;
}
TQDomNamedNodeMapPrivate* TQDomNodePrivate::attributes()
{
return 0;
}
TQDomNodePrivate* TQDomNodePrivate::insertBefore( TQDomNodePrivate* newChild, TQDomNodePrivate* refChild )
{
// Error check
if ( !newChild )
return 0;
// Error check
if ( newChild == refChild )
return 0;
// Error check
if ( refChild && refChild->parent() != this )
return 0;
// "mark lists as dirty"
qt_nodeListTime++;
// Special handling for inserting a fragment. We just insert
// all elements of the fragment instead of the fragment itself.
if ( newChild->isDocumentFragment() ) {
// Fragment is empty ?
if ( newChild->first == 0 )
return newChild;
// New parent
TQDomNodePrivate* n = newChild->first;
while ( n ) {
n->setParent( this );
n = n->next;
}
// Insert at the beginning ?
if ( !refChild || refChild->prev == 0 ) {
if ( first )
first->prev = newChild->last;
newChild->last->next = first;
if ( !last )
last = newChild->last;
first = newChild->first;
} else {
// Insert in the middle
newChild->last->next = refChild;
newChild->first->prev = refChild->prev;
refChild->prev->next = newChild->first;
refChild->prev = newChild->last;
}
// No need to increase the reference since TQDomDocumentFragment
// does not decrease the reference.
// Remove the nodes from the fragment
newChild->first = 0;
newChild->last = 0;
return newChild;
}
// No more errors can occur now, so we take
// ownership of the node.
newChild->ref();
if ( newChild->parent() )
newChild->parent()->removeChild( newChild );
newChild->setParent( this );
if ( !refChild ) {
if ( first )
first->prev = newChild;
newChild->next = first;
if ( !last )
last = newChild;
first = newChild;
return newChild;
}
if ( refChild->prev == 0 ) {
if ( first )
first->prev = newChild;
newChild->next = first;
if ( !last )
last = newChild;
first = newChild;
return newChild;
}
newChild->next = refChild;
newChild->prev = refChild->prev;
refChild->prev->next = newChild;
refChild->prev = newChild;
return newChild;
}
TQDomNodePrivate* TQDomNodePrivate::insertAfter( TQDomNodePrivate* newChild, TQDomNodePrivate* refChild )
{
// Error check
if ( !newChild )
return 0;
// Error check
if ( newChild == refChild )
return 0;
// Error check
if ( refChild && refChild->parent() != this )
return 0;
// "mark lists as dirty"
qt_nodeListTime++;
// Special handling for inserting a fragment. We just insert
// all elements of the fragment instead of the fragment itself.
if ( newChild->isDocumentFragment() ) {
// Fragment is empty ?
if ( newChild->first == 0 )
return newChild;
// New parent
TQDomNodePrivate* n = newChild->first;
while ( n ) {
n->setParent( this );
n = n->next;
}
// Insert at the end
if ( !refChild || refChild->next == 0 ) {
if ( last )
last->next = newChild->first;
newChild->first->prev = last;
if ( !first )
first = newChild->first;
last = newChild->last;
} else { // Insert in the middle
newChild->first->prev = refChild;
newChild->last->next = refChild->next;
refChild->next->prev = newChild->last;
refChild->next = newChild->first;
}
// No need to increase the reference since TQDomDocumentFragment
// does not decrease the reference.
// Remove the nodes from the fragment
newChild->first = 0;
newChild->last = 0;
return newChild;
}
// Release new node from its current parent
if ( newChild->parent() )
newChild->parent()->removeChild( newChild );
// No more errors can occur now, so we take
// ownership of the node
newChild->ref();
newChild->setParent( this );
// Insert at the end
if ( !refChild ) {
if ( last )
last->next = newChild;
newChild->prev = last;
if ( !first )
first = newChild;
last = newChild;
return newChild;
}
if ( refChild->next == 0 ) {
if ( last )
last->next = newChild;
newChild->prev = last;
if ( !first )
first = newChild;
last = newChild;
return newChild;
}
newChild->prev = refChild;
newChild->next = refChild->next;
refChild->next->prev = newChild;
refChild->next = newChild;
return newChild;
}
TQDomNodePrivate* TQDomNodePrivate::replaceChild( TQDomNodePrivate* newChild, TQDomNodePrivate* oldChild )
{
if ( oldChild->parent() != this )
return 0;
if ( !newChild || !oldChild )
return 0;
if ( newChild == oldChild )
return 0;
// mark lists as dirty
qt_nodeListTime++;
// Special handling for inserting a fragment. We just insert
// all elements of the fragment instead of the fragment itself.
if ( newChild->isDocumentFragment() ) {
// Fragment is empty ?
if ( newChild->first == 0 )
return newChild;
// New parent
TQDomNodePrivate* n = newChild->first;
while ( n ) {
n->setParent( this );
n = n->next;
}
if ( oldChild->next )
oldChild->next->prev = newChild->last;
if ( oldChild->prev )
oldChild->prev->next = newChild->first;
newChild->last->next = oldChild->next;
newChild->first->prev = oldChild->prev;
if ( first == oldChild )
first = newChild->first;
if ( last == oldChild )
last = newChild->last;
oldChild->setNoParent();
oldChild->next = 0;
oldChild->prev = 0;
// No need to increase the reference since TQDomDocumentFragment
// does not decrease the reference.
// Remove the nodes from the fragment
newChild->first = 0;
newChild->last = 0;
// We are no longer interested in the old node
if ( oldChild ) oldChild->deref();
return oldChild;
}
// No more errors can occur now, so we take
// ownership of the node
newChild->ref();
// Release new node from its current parent
if ( newChild->parent() )
newChild->parent()->removeChild( newChild );
newChild->setParent( this );
if ( oldChild->next )
oldChild->next->prev = newChild;
if ( oldChild->prev )
oldChild->prev->next = newChild;
newChild->next = oldChild->next;
newChild->prev = oldChild->prev;
if ( first == oldChild )
first = newChild;
if ( last == oldChild )
last = newChild;
oldChild->setNoParent();
oldChild->next = 0;
oldChild->prev = 0;
// We are no longer interested in the old node
if ( oldChild ) oldChild->deref();
return oldChild;
}
TQDomNodePrivate* TQDomNodePrivate::removeChild( TQDomNodePrivate* oldChild )
{
// Error check
if ( oldChild->parent() != this )
return 0;
// "mark lists as dirty"
qt_nodeListTime++;
// Perhaps oldChild was just created with "createElement" or that. In this case
// its parent is TQDomDocument but it is not part of the documents child list.
if ( oldChild->next == 0 && oldChild->prev == 0 && first != oldChild )
return 0;
if ( oldChild->next )
oldChild->next->prev = oldChild->prev;
if ( oldChild->prev )
oldChild->prev->next = oldChild->next;
if ( last == oldChild )
last = oldChild->prev;
if ( first == oldChild )
first = oldChild->next;
oldChild->setNoParent();
oldChild->next = 0;
oldChild->prev = 0;
// We are no longer interested in the old node
if ( oldChild ) oldChild->deref();
return oldChild;
}
TQDomNodePrivate* TQDomNodePrivate::appendChild( TQDomNodePrivate* newChild )
{
// No reference manipulation needed. Done in insertAfter.
return insertAfter( newChild, 0 );
}
TQDomDocumentPrivate* TQDomNodePrivate::ownerDocument()
{
TQDomNodePrivate* p = this;
while ( p && !p->isDocument() ) {
if ( !p->hasParent )
return (TQDomDocumentPrivate*)p->ownerNode;
p = p->parent();
}
return (TQDomDocumentPrivate*)p;
}
TQDomNodePrivate* TQDomNodePrivate::cloneNode( bool deep )
{
TQDomNodePrivate* p = new TQDomNodePrivate( this, deep );
// We are not interested in this node
p->deref();
return p;
}
static void qNormalizeNode( TQDomNodePrivate* n )
{
TQDomNodePrivate* p = n->first;
TQDomTextPrivate* t = 0;
while ( p ) {
if ( p->isText() ) {
if ( t ) {
TQDomNodePrivate* tmp = p->next;
t->appendData( p->nodeValue() );
n->removeChild( p );
p = tmp;
} else {
t = (TQDomTextPrivate*)p;
p = p->next;
}
} else {
p = p->next;
t = 0;
}
}
}
void TQDomNodePrivate::normalize()
{
// ### This one has moved from TQDomElementPrivate to this position. It is
// not tested.
qNormalizeNode( this );
}
void TQDomNodePrivate::save( TQTextStream& s, int depth, int indent ) const
{
const TQDomNodePrivate* n = first;
while ( n ) {
n->save( s, depth, indent );
n = n->next;
}
}
/**************************************************************
*
* TQDomNode
*
**************************************************************/
#define IMPL ((TQDomNodePrivate*)impl)
/*!
\class TQDomNode ntqdom.h
\reentrant
\brief The TQDomNode class is the base class for all the nodes in a DOM tree.
\if defined(commercial)
It is part of the <a href="commercialeditions.html">TQt Enterprise Edition</a>.
\endif
\module XML
\ingroup xml-tools
Many functions in the DOM return a TQDomNode.
You can find out the type of a node using isAttr(),
isCDATASection(), isDocumentFragment(), isDocument(),
isDocumentType(), isElement(), isEntityReference(), isText(),
isEntity(), isNotation(), isProcessingInstruction(),
isCharacterData() and isComment().
A TQDomNode can be converted into one of its subclasses using
toAttr(), toCDATASection(), toDocumentFragment(), toDocument(),
toDocumentType(), toElement(), toEntityReference(), toText(),
toEntity(), toNotation(), toProcessingInstruction(),
toCharacterData() or toComment(). You can convert a node to a null
node with clear().
Copies of the TQDomNode class share their data using explicit
sharing. This means that modifying one node will change all
copies. This is especially useful in combination with functions
which return a TQDomNode, e.g. firstChild(). You can make an
independent (deep) copy of the node with cloneNode().
Nodes are inserted with insertBefore(), insertAfter() or
appendChild(). You can replace one node with another using
replaceChild() and remove a node with removeChild().
To traverse nodes use firstChild() to get a node's first child (if
any), and nextSibling() to traverse. TQDomNode also provides
lastChild(), previousSibling() and parentNode(). To find the first
child node with a particular node name use namedItem().
To find out if a node has children use hasChildNodes() and to get
a list of all of a node's children use childNodes().
The node's name and value (the meaning of which varies depending
on its type) is returned by nodeName() and nodeValue()
respectively. The node's type is returned by nodeType(). The
node's value can be set with setNodeValue().
The document to which the node belongs is returned by
ownerDocument().
Adjacent TQDomText nodes can be merged into a single node with
normalize().
\l TQDomElement nodes have attributes which can be retrieved with
attributes().
TQDomElement and TQDomAttr nodes can have namespaces which can be
retrieved with namespaceURI(). Their local name is retrieved with
localName(), and their prefix with prefix(). The prefix can be set
with setPrefix().
You can write the XML representation of the node to a text stream
with save().
The following example looks for the first element in an XML document and
prints the names of all the elements that are its direct children.
\code
TQDomDocument d;
d.setContent( someXML );
TQDomNode n = d.firstChild();
while ( !n.isNull() ) {
if ( n.isElement() ) {
TQDomElement e = n.toElement();
cout << "Element name: " << e.tagName() << endl;
break;
}
n = n.nextSibling();
}
\endcode
For further information about the Document Object Model see \link
http://www.w3.org/TR/REC-DOM-Level-1/\endlink and \link
http://www.w3.org/TR/DOM-Level-2-Core/\endlink. For a more general
introduction of the DOM implementation see the TQDomDocument
documentation.
*/
/*!
Constructs a \link isNull() null\endlink node.
*/
TQDomNode::TQDomNode()
{
impl = 0;
}
/*!
Constructs a copy of \a n.
The data of the copy is shared (shallow copy): modifying one node
will also change the other. If you want to make a deep copy, use
cloneNode().
*/
TQDomNode::TQDomNode( const TQDomNode& n )
{
impl = n.impl;
if ( impl ) impl->ref();
}
/*! \internal
Constructs a new node for the data \a n.
*/
TQDomNode::TQDomNode( TQDomNodePrivate* n )
{
impl = n;
if ( impl ) impl->ref();
}
/*!
Assigns a copy of \a n to this DOM node.
The data of the copy is shared (shallow copy): modifying one node
will also change the other. If you want to make a deep copy, use
cloneNode().
*/
TQDomNode& TQDomNode::operator= ( const TQDomNode& n )
{
if ( n.impl ) n.impl->ref();
if ( impl && impl->deref() ) delete impl;
impl = n.impl;
return *this;
}
/*!
Returns TRUE if \a n and this DOM node are equal; otherwise
returns FALSE.
*/
bool TQDomNode::operator== ( const TQDomNode& n ) const
{
return ( impl == n.impl );
}
/*!
Returns TRUE if \a n and this DOM node are not equal; otherwise
returns FALSE.
*/
bool TQDomNode::operator!= ( const TQDomNode& n ) const
{
return ( impl != n.impl );
}
/*!
Destroys the object and frees its resources.
*/
TQDomNode::~TQDomNode()
{
if ( impl && impl->deref() ) delete impl;
}
/*!
Returns the name of the node.
The meaning of the name depends on the subclass:
\table
\header \i Name \i Meaning
\row \i TQDomAttr \i The name of the attribute
\row \i TQDomCDATASection \i The string "#cdata-section"
\row \i TQDomComment \i The string "#comment"
\row \i TQDomDocument \i The string "#document"
\row \i TQDomDocumentFragment \i The string "#document-fragment"
\row \i TQDomDocumentType \i The name of the document type
\row \i TQDomElement \i The tag name
\row \i TQDomEntity \i The name of the entity
\row \i TQDomEntityReference \i The name of the referenced entity
\row \i TQDomNotation \i The name of the notation
\row \i TQDomProcessingInstruction \i The target of the processing instruction
\row \i TQDomText \i The string "#text"
\endtable
\sa nodeValue()
*/
TQString TQDomNode::nodeName() const
{
if ( !impl )
return TQString::null;
if ( !IMPL->prefix.isEmpty() )
return IMPL->prefix + ":" + IMPL->name;
return IMPL->name;
}
/*!
Returns the value of the node.
The meaning of the value depends on the subclass:
\table
\header \i Name \i Meaning
\row \i TQDomAttr \i The attribute value
\row \i TQDomCDATASection \i The content of the CDATA section
\row \i TQDomComment \i The comment
\row \i TQDomProcessingInstruction \i The data of the processing intruction
\row \i TQDomText \i The text
\endtable
All the other subclasses do not have a node value and will return
TQString::null.
\sa setNodeValue() nodeName()
*/
TQString TQDomNode::nodeValue() const
{
if ( !impl )
return TQString::null;
return IMPL->value;
}
/*!
Sets the node's value to \a v.
\sa nodeValue()
*/
void TQDomNode::setNodeValue( const TQString& v )
{
if ( !impl )
return;
IMPL->setNodeValue( v );
}
/*!
\enum TQDomNode::NodeType
This enum defines the type of the node:
\value ElementNode
\value AttributeNode
\value TextNode
\value CDATASectionNode
\value EntityReferenceNode
\value EntityNode
\value ProcessingInstructionNode
\value CommentNode
\value DocumentNode
\value DocumentTypeNode
\value DocumentFragmentNode
\value NotationNode
\value BaseNode A TQDomNode object, i.e. not a TQDomNode subclass.
\value CharacterDataNode
*/
/*!
Returns the type of the node.
\sa toAttr(), toCDATASection(), toDocumentFragment(),
toDocument() toDocumentType(), toElement(), toEntityReference(),
toText(), toEntity() toNotation(), toProcessingInstruction(),
toCharacterData(), toComment()
*/
TQDomNode::NodeType TQDomNode::nodeType() const
{
if ( !impl )
return TQDomNode::BaseNode;
return IMPL->nodeType();
}
/*!
Returns the parent node. If this node has no parent, a null node
is returned (i.e. a node for which isNull() returns TRUE).
*/
TQDomNode TQDomNode::parentNode() const
{
if ( !impl )
return TQDomNode();
return TQDomNode( IMPL->parent() );
}
/*!
Returns a list of all direct child nodes.
Most often you will call this function on a TQDomElement object.
For example, if the XML document looks like this:
\code
<body>
<h1>Heading</h1>
<p>Hello <b>you</b></p>
</body>
\endcode
Then the list of child nodes for the "body"-element will contain
the node created by the <h1> tag and the node created by the
<p> tag.
The nodes in the list are not copied; so changing the nodes in the
list will also change the children of this node.
\sa firstChild() lastChild()
*/
TQDomNodeList TQDomNode::childNodes() const
{
if ( !impl )
return TQDomNodeList();
return TQDomNodeList( new TQDomNodeListPrivate( impl ) );
}
/*!
Returns the first child of the node. If there is no child node, a
\link isNull() null node\endlink is returned. Changing the
returned node will also change the node in the document tree.
\sa lastChild() childNodes()
*/
TQDomNode TQDomNode::firstChild() const
{
if ( !impl )
return TQDomNode();
return TQDomNode( IMPL->first );
}
/*!
Returns the last child of the node. If there is no child node, a
\link isNull() null node\endlink is returned. Changing the
returned node will also change the node in the document tree.
\sa firstChild() childNodes()
*/
TQDomNode TQDomNode::lastChild() const
{
if ( !impl )
return TQDomNode();
return TQDomNode( IMPL->last );
}
/*!
Returns the previous sibling in the document tree. Changing the
returned node will also change the node in the document tree.
For example, if you have XML like this:
\code
<h1>Heading</h1>
<p>The text...</p>
<h2>Next heading</h2>
\endcode
and this TQDomNode represents the <p> tag, previousSibling()
will return the node representing the <h1> tag.
\sa nextSibling()
*/
TQDomNode TQDomNode::previousSibling() const
{
if ( !impl )
return TQDomNode();
return TQDomNode( IMPL->prev );
}
/*!
Returns the next sibling in the document tree. Changing the
returned node will also change the node in the document tree.
If you have XML like this:
\code
<h1>Heading</h1>
<p>The text...</p>
<h2>Next heading</h2>
\endcode
and this TQDomNode represents the <p> tag, nextSibling() will
return the node representing the <h2> tag.
\sa previousSibling()
*/
TQDomNode TQDomNode::nextSibling() const
{
if ( !impl )
return TQDomNode();
return TQDomNode( IMPL->next );
}
/*!
Returns a named node map of all attributes. Attributes are only
provided for \l{TQDomElement}s.
Changing the attributes in the map will also change the attributes
of this TQDomNode.
*/
TQDomNamedNodeMap TQDomNode::attributes() const
{
if ( !impl )
return TQDomNamedNodeMap();
return TQDomNamedNodeMap( impl->attributes() );
}
/*!
Returns the document to which this node belongs.
*/
TQDomDocument TQDomNode::ownerDocument() const
{
if ( !impl )
return TQDomDocument();
return TQDomDocument( IMPL->ownerDocument() );
}
/*!
Creates a deep (not shallow) copy of the TQDomNode.
If \a deep is TRUE, then the cloning is done recursively which
means that all the node's children are deep copied too. If \a deep
is FALSE only the node itself is copied and the copy will have no
child nodes.
*/
TQDomNode TQDomNode::cloneNode( bool deep ) const
{
if ( !impl )
return TQDomNode();
return TQDomNode( IMPL->cloneNode( deep ) );
}
/*!
Calling normalize() on an element converts all its children into a
standard form. This means that adjacent TQDomText objects will be
merged into a single text object (TQDomCDATASection nodes are not
merged).
*/
void TQDomNode::normalize()
{
if ( !impl )
return;
IMPL->normalize();
}
/*!
Returns TRUE if the DOM implementation implements the feature \a
feature and this feature is supported by this node in the version
\a version; otherwise returns FALSE.
\sa TQDomImplementation::hasFeature()
*/
bool TQDomNode::isSupported( const TQString& feature, const TQString& version ) const
{
TQDomImplementation i;
return i.hasFeature( feature, version );
}
/*!
Returns the namespace URI of this node or TQString::null if the
node has no namespace URI.
Only nodes of type \link TQDomNode::NodeType ElementNode\endlink or
\link TQDomNode::NodeType AttributeNode\endlink can have
namespaces. A namespace URI must be specified at creation time and
cannot be changed later.
\sa prefix() localName() TQDomDocument::createElementNS()
TQDomDocument::createAttributeNS()
*/
TQString TQDomNode::namespaceURI() const
{
if ( !impl )
return TQString::null;
return IMPL->namespaceURI;
}
/*!
Returns the namespace prefix of the node or TQString::null if the
node has no namespace prefix.
Only nodes of type \link TQDomNode::NodeType ElementNode\endlink or
\link TQDomNode::NodeType AttributeNode\endlink can have
namespaces. A namespace prefix must be specified at creation time.
If a node was created with a namespace prefix, you can change it
later with setPrefix().
If you create an element or attribute with
TQDomDocument::createElement() or TQDomDocument::createAttribute(),
the prefix will be TQString::null. If you use
TQDomDocument::createElementNS() or
TQDomDocument::createAttributeNS() instead, the prefix will not be
TQString::null; but it might be an empty string if the name does
not have a prefix.
\sa setPrefix() localName() namespaceURI()
TQDomDocument::createElementNS() TQDomDocument::createAttributeNS()
*/
TQString TQDomNode::prefix() const
{
if ( !impl )
return TQString::null;
return IMPL->prefix;
}
/*!
If the node has a namespace prefix, this function changes the
namespace prefix of the node to \a pre. Otherwise this function
does nothing.
Only nodes of type \link TQDomNode::NodeType ElementNode\endlink or
\link TQDomNode::NodeType AttributeNode\endlink can have
namespaces. A namespace prefix must have be specified at creation
time; it is not possible to add a namespace prefix afterwards.
\sa prefix() localName() namespaceURI()
TQDomDocument::createElementNS() TQDomDocument::createAttributeNS()
*/
void TQDomNode::setPrefix( const TQString& pre )
{
if ( !impl || IMPL->prefix.isNull() )
return;
if ( isAttr() || isElement() )
IMPL->prefix = pre;
}
/*!
If the node uses namespaces, this function returns the local name
of the node; otherwise it returns TQString::null.
Only nodes of type \link TQDomNode::NodeType ElementNode\endlink or
\link TQDomNode::NodeType AttributeNode\endlink can have
namespaces. A namespace must have been specified at creation time;
it is not possible to add a namespace afterwards.
\sa prefix() namespaceURI() TQDomDocument::createElementNS()
TQDomDocument::createAttributeNS()
*/
TQString TQDomNode::localName() const
{
if ( !impl || IMPL->createdWithDom1Interface )
return TQString::null;
return IMPL->name;
}
/*!
Returns TRUE if the node has attributes; otherwise returns FALSE.
\sa attributes()
*/
bool TQDomNode::hasAttributes() const
{
if ( !impl )
return FALSE;
return IMPL->hasAttributes();
}
/*!
Inserts the node \a newChild before the child node \a refChild.
\a refChild must be a direct child of this node. If \a refChild is
\link isNull() null\endlink then \a newChild is inserted as the
node's first child.
If \a newChild is the child of another node, it is reparented to
this node. If \a newChild is a child of this node, then its
position in the list of children is changed.
If \a newChild is a TQDomDocumentFragment, then the children of the
fragment are removed from the fragment and inserted before \a
refChild.
Returns a new reference to \a newChild on success or a \link
isNull() null node\endlink on failure.
\sa insertAfter() replaceChild() removeChild() appendChild()
*/
TQDomNode TQDomNode::insertBefore( const TQDomNode& newChild, const TQDomNode& refChild )
{
if ( !impl ) {
if (nodeType() == DocumentNode)
impl = new TQDomDocumentPrivate;
else
return TQDomNode();
}
return TQDomNode( IMPL->insertBefore( newChild.impl, refChild.impl ) );
}
/*!
Inserts the node \a newChild after the child node \a refChild. \a
refChild must be a direct child of this node. If \a refChild is
\link isNull() null\endlink then \a newChild is appended as this
node's last child.
If \a newChild is the child of another node, it is reparented to
this node. If \a newChild is a child of this node, then its
position in the list of children is changed.
If \a newChild is a TQDomDocumentFragment, then the children of the
fragment are removed from the fragment and inserted after \a
refChild.
Returns a new reference to \a newChild on success or a \link
isNull() null node\endlink on failure.
\sa insertBefore() replaceChild() removeChild() appendChild()
*/
TQDomNode TQDomNode::insertAfter( const TQDomNode& newChild, const TQDomNode& refChild )
{
if ( !impl ) {
if (nodeType() == DocumentNode)
impl = new TQDomDocumentPrivate;
else
return TQDomNode();
}
return TQDomNode( IMPL->insertAfter( newChild.impl, refChild.impl ) );
}
/*!
Replaces \a oldChild with \a newChild. \a oldChild must be a
direct child of this node.
If \a newChild is the child of another node, it is reparented to
this node. If \a newChild is a child of this node, then its
position in the list of children is changed.
If \a newChild is a TQDomDocumentFragment, then \a oldChild is
replaced by all of the children of the fragment.
Returns a new reference to \a oldChild on success or a \link
isNull() null node\endlink an failure.
\sa insertBefore() insertAfter() removeChild() appendChild()
*/
TQDomNode TQDomNode::replaceChild( const TQDomNode& newChild, const TQDomNode& oldChild )
{
if ( !impl ) {
if (nodeType() == DocumentNode)
impl = new TQDomDocumentPrivate;
else
return TQDomNode();
}
return TQDomNode( IMPL->replaceChild( newChild.impl, oldChild.impl ) );
}
/*!
Removes \a oldChild from the list of children. \a oldChild must be
a direct child of this node.
Returns a new reference to \a oldChild on success or a \link
isNull() null node\endlink on failure.
\sa insertBefore() insertAfter() replaceChild() appendChild()
*/
TQDomNode TQDomNode::removeChild( const TQDomNode& oldChild )
{
if ( !impl )
return TQDomNode();
if ( oldChild.isNull() )
return TQDomNode();
return TQDomNode( IMPL->removeChild( oldChild.impl ) );
}
/*!
Appends \a newChild as the node's last child.
If \a newChild is the child of another node, it is reparented to
this node. If \a newChild is a child of this node, then its
position in the list of children is changed.
If \a newChild is a TQDomDocumentFragment, then the children of the
fragment are removed from the fragment and appended.
Returns a new reference to \a newChild.
\sa insertBefore() insertAfter() replaceChild() removeChild()
*/
TQDomNode TQDomNode::appendChild( const TQDomNode& newChild )
{
if ( !impl ) {
if (nodeType() == DocumentNode)
impl = new TQDomDocumentPrivate;
else
return TQDomNode();
}
return TQDomNode( IMPL->appendChild( newChild.impl ) );
}
/*!
Returns TRUE if the node has one or more children; otherwise
returns FALSE.
*/
bool TQDomNode::hasChildNodes() const
{
if ( !impl )
return FALSE;
return IMPL->first != 0;
}
/*!
Returns TRUE if this node is null (i.e. if it has no type or
contents); otherwise returns FALSE.
*/
bool TQDomNode::isNull() const
{
return ( impl == 0 );
}
/*!
Converts the node into a null node; if it was not a null node
before, its type and contents are deleted.
\sa isNull()
*/
void TQDomNode::clear()
{
if ( impl && impl->deref() ) delete impl;
impl = 0;
}
/*!
Returns the first direct child node for which nodeName() equals \a
name.
If no such direct child exists, a \link isNull() null node\endlink
is returned.
\sa nodeName()
*/
TQDomNode TQDomNode::namedItem( const TQString& name ) const
{
if ( !impl )
return TQDomNode();
return TQDomNode( impl->namedItem( name ) );
}
/*!
Writes the XML representation of the node and all its children to
the stream \a str. This function uses \a indent as the amount of
space to indent the node.
*/
void TQDomNode::save( TQTextStream& str, int indent ) const
{
if ( impl )
IMPL->save( str, 1, indent );
}
/*!
\relates TQDomNode
Writes the XML representation of the node \a node and all its
children to the stream \a str.
*/
TQTextStream& operator<<( TQTextStream& str, const TQDomNode& node )
{
node.save( str, 1 );
return str;
}
/*!
Returns TRUE if the node is an attribute; otherwise returns FALSE.
If this function returns TRUE, it does not imply that this object
is a TQDomAttribute; you can get the TQDomAttribute with
toAttribute().
\sa toAttr()
*/
bool TQDomNode::isAttr() const
{
if(impl)
return impl->isAttr();
return FALSE;
}
/*!
Returns TRUE if the node is a CDATA section; otherwise returns
FALSE.
If this function returns TRUE, it does not imply that this object
is a TQDomCDATASection; you can get the TQDomCDATASection with
toCDATASection().
\sa toCDATASection()
*/
bool TQDomNode::isCDATASection() const
{
if(impl)
return impl->isCDATASection();
return FALSE;
}
/*!
Returns TRUE if the node is a document fragment; otherwise returns
FALSE.
If this function returns TRUE, it does not imply that this object
is a TQDomDocumentFragment; you can get the TQDomDocumentFragment
with toDocumentFragment().
\sa toDocumentFragment()
*/
bool TQDomNode::isDocumentFragment() const
{
if(impl)
return impl->isDocumentFragment();
return FALSE;
}
/*!
Returns TRUE if the node is a document; otherwise returns FALSE.
If this function returns TRUE, it does not imply that this object
is a TQDomDocument; you can get the TQDomDocument with toDocument().
\sa toDocument()
*/
bool TQDomNode::isDocument() const
{
if(impl)
return impl->isDocument();
return FALSE;
}
/*!
Returns TRUE if the node is a document type; otherwise returns
FALSE.
If this function returns TRUE, it does not imply that this object
is a TQDomDocumentType; you can get the TQDomDocumentType with
toDocumentType().
\sa toDocumentType()
*/
bool TQDomNode::isDocumentType() const
{
if(impl)
return impl->isDocumentType();
return FALSE;
}
/*!
Returns TRUE if the node is an element; otherwise returns FALSE.
If this function returns TRUE, it does not imply that this object
is a TQDomElement; you can get the TQDomElement with toElement().
\sa toElement()
*/
bool TQDomNode::isElement() const
{
if(impl)
return impl->isElement();
return FALSE;
}
/*!
Returns TRUE if the node is an entity reference; otherwise returns
FALSE.
If this function returns TRUE, it does not imply that this object
is a TQDomEntityReference; you can get the TQDomEntityReference with
toEntityReference().
\sa toEntityReference()
*/
bool TQDomNode::isEntityReference() const
{
if(impl)
return impl->isEntityReference();
return FALSE;
}
/*!
Returns TRUE if the node is a text node; otherwise returns FALSE.
If this function returns TRUE, it does not imply that this object
is a TQDomText; you can get the TQDomText with toText().
\sa toText()
*/
bool TQDomNode::isText() const
{
if(impl)
return impl->isText();
return FALSE;
}
/*!
Returns TRUE if the node is an entity; otherwise returns FALSE.
If this function returns TRUE, it does not imply that this object
is a TQDomEntity; you can get the TQDomEntity with toEntity().
\sa toEntity()
*/
bool TQDomNode::isEntity() const
{
if(impl)
return impl->isEntity();
return FALSE;
}
/*!
Returns TRUE if the node is a notation; otherwise returns FALSE.
If this function returns TRUE, it does not imply that this object
is a TQDomNotation; you can get the TQDomNotation with toNotation().
\sa toNotation()
*/
bool TQDomNode::isNotation() const
{
if(impl)
return impl->isNotation();
return FALSE;
}
/*!
Returns TRUE if the node is a processing instruction; otherwise
returns FALSE.
If this function returns TRUE, it does not imply that this object
is a TQDomProcessingInstruction; you can get the
TQProcessingInstruction with toProcessingInstruction().
\sa toProcessingInstruction()
*/
bool TQDomNode::isProcessingInstruction() const
{
if(impl)
return impl->isProcessingInstruction();
return FALSE;
}
/*!
Returns TRUE if the node is a character data node; otherwise
returns FALSE.
If this function returns TRUE, it does not imply that this object
is a TQDomCharacterData; you can get the TQDomCharacterData with
toCharacterData().
\sa toCharacterData()
*/
bool TQDomNode::isCharacterData() const
{
if(impl)
return impl->isCharacterData();
return FALSE;
}
/*!
Returns TRUE if the node is a comment; otherwise returns FALSE.
If this function returns TRUE, it does not imply that this object
is a TQDomComment; you can get the TQDomComment with toComment().
\sa toComment()
*/
bool TQDomNode::isComment() const
{
if(impl)
return impl->isComment();
return FALSE;
}
#undef IMPL
/**************************************************************
*
* TQDomNamedNodeMapPrivate
*
**************************************************************/
TQDomNamedNodeMapPrivate::TQDomNamedNodeMapPrivate( TQDomNodePrivate* n )
{
readonly = FALSE;
parent = n;
appendToParent = FALSE;
}
TQDomNamedNodeMapPrivate::~TQDomNamedNodeMapPrivate()
{
clearMap();
}
TQDomNamedNodeMapPrivate* TQDomNamedNodeMapPrivate::clone( TQDomNodePrivate* p )
{
TQDomNamedNodeMapPrivate* m = new TQDomNamedNodeMapPrivate( p );
m->readonly = readonly;
m->appendToParent = appendToParent;
TQDictIterator<TQDomNodePrivate> it ( map );
for ( ; it.current(); ++it )
m->setNamedItem( it.current()->cloneNode() );
// we are no longer interested in ownership
m->deref();
return m;
}
void TQDomNamedNodeMapPrivate::clearMap()
{
// Dereference all of our children if we took references
if ( !appendToParent ) {
TQDictIterator<TQDomNodePrivate> it( map );
for ( ; it.current(); ++it )
if ( it.current()->deref() )
delete it.current();
}
map.clear();
}
TQDomNodePrivate* TQDomNamedNodeMapPrivate::namedItem( const TQString& name ) const
{
TQDomNodePrivate* p = map[ name ];
return p;
}
TQDomNodePrivate* TQDomNamedNodeMapPrivate::namedItemNS( const TQString& nsURI, const TQString& localName ) const
{
TQDictIterator<TQDomNodePrivate> it( map );
TQDomNodePrivate *n = it.current();
while ( n ) {
if ( !n->prefix.isNull() ) {
// node has a namespace
if ( n->namespaceURI==nsURI && n->name==localName ) {
return n;
}
}
++it;
n = it.current();
}
return 0;
}
TQDomNodePrivate* TQDomNamedNodeMapPrivate::setNamedItem( TQDomNodePrivate* arg )
{
if ( readonly || !arg )
return 0;
if ( appendToParent )
return parent->appendChild( arg );
TQDomNodePrivate *n = map[ arg->nodeName() ];
// We take a reference
arg->ref();
map.insert( arg->nodeName(), arg );
return n;
}
TQDomNodePrivate* TQDomNamedNodeMapPrivate::setNamedItemNS( TQDomNodePrivate* arg )
{
if ( readonly || !arg )
return 0;
if ( appendToParent )
return parent->appendChild( arg );
if ( !arg->prefix.isNull() ) {
// node has a namespace
TQDomNodePrivate *n = namedItemNS( arg->namespaceURI, arg->name );
// We take a reference
arg->ref();
map.insert( arg->nodeName(), arg );
return n;
} else {
// ### check the following code if it is ok
return setNamedItem( arg );
}
}
TQDomNodePrivate* TQDomNamedNodeMapPrivate::removeNamedItem( const TQString& name )
{
if ( readonly )
return 0;
TQDomNodePrivate* p = namedItem( name );
if ( p == 0 )
return 0;
if ( appendToParent )
return parent->removeChild( p );
map.remove( p->nodeName() );
// We took a reference, so we have to free one here
p->deref();
return p;
}
TQDomNodePrivate* TQDomNamedNodeMapPrivate::item( int index ) const
{
if ( (uint)index >= length() )
return 0;
TQDictIterator<TQDomNodePrivate> it( map );
for ( int i = 0; i < index; ++i, ++it )
;
return it.current();
}
uint TQDomNamedNodeMapPrivate::length() const
{
return map.count();
}
bool TQDomNamedNodeMapPrivate::contains( const TQString& name ) const
{
return ( map[ name ] != 0 );
}
bool TQDomNamedNodeMapPrivate::containsNS( const TQString& nsURI, const TQString & localName ) const
{
return ( namedItemNS( nsURI, localName ) != 0 );
}
/**************************************************************
*
* TQDomNamedNodeMap
*
**************************************************************/
#define IMPL ((TQDomNamedNodeMapPrivate*)impl)
/*!
\class TQDomNamedNodeMap ntqdom.h
\reentrant
\brief The TQDomNamedNodeMap class contains a collection of nodes
that can be accessed by name.
\if defined(commercial)
It is part of the <a href="commercialeditions.html">TQt Enterprise Edition</a>.
\endif
\module XML
\ingroup xml-tools
Note that TQDomNamedNodeMap does not inherit from TQDomNodeList.
TQDomNamedNodeMaps do not provide any specific node ordering.
Although nodes in a TQDomNamedNodeMap may be accessed by an ordinal
index, this is simply to allow a convenient enumeration of the
contents of a TQDomNamedNodeMap, and does not imply that the DOM
specifies an ordering of the nodes.
The TQDomNamedNodeMap is used in three places:
\list 1
\i TQDomDocumentType::entities() returns a map of all entities
described in the DTD.
\i TQDomDocumentType::notations() returns a map of all notations
described in the DTD.
\i TQDomNode::attributes() returns a map of all attributes of an
element.
\endlist
Items in the map are identified by the name which TQDomNode::name()
returns. Nodes are retrieved using namedItem(), namedItemNS() or
item(). New nodes are inserted with setNamedItem() or
setNamedItemNS() and removed with removeNamedItem() or
removeNamedItemNS(). Use contains() to see if an item with the
given name is in the named node map. The number of items is
returned by length().
Terminology: in this class we use "item" and "node"
interchangeably.
*/
/*!
Constructs an empty named node map.
*/
TQDomNamedNodeMap::TQDomNamedNodeMap()
{
impl = 0;
}
/*!
Constructs a copy of \a n.
*/
TQDomNamedNodeMap::TQDomNamedNodeMap( const TQDomNamedNodeMap& n )
{
impl = n.impl;
if ( impl )
impl->ref();
}
TQDomNamedNodeMap::TQDomNamedNodeMap( TQDomNamedNodeMapPrivate* n )
{
impl = n;
if ( impl )
impl->ref();
}
/*!
Assigns \a n to this named node map.
*/
TQDomNamedNodeMap& TQDomNamedNodeMap::operator= ( const TQDomNamedNodeMap& n )
{
if ( impl && impl->deref() )
delete impl;
impl = n.impl;
if ( impl )
impl->ref();
return *this;
}
/*!
Returns TRUE if \a n and this named node map are equal; otherwise
returns FALSE.
*/
bool TQDomNamedNodeMap::operator== ( const TQDomNamedNodeMap& n ) const
{
return ( impl == n.impl );
}
/*!
Returns TRUE if \a n and this named node map are not equal;
otherwise returns FALSE.
*/
bool TQDomNamedNodeMap::operator!= ( const TQDomNamedNodeMap& n ) const
{
return ( impl != n.impl );
}
/*!
Destroys the object and frees its resources.
*/
TQDomNamedNodeMap::~TQDomNamedNodeMap()
{
if ( impl && impl->deref() )
delete impl;
}
/*!
Returns the node called \a name.
If the named node map does not contain such a node, a \link
TQDomNode::isNull() null node\endlink is returned. A node's name is
the name returned by TQDomNode::nodeName().
\sa setNamedItem() namedItemNS()
*/
TQDomNode TQDomNamedNodeMap::namedItem( const TQString& name ) const
{
if ( !impl )
return TQDomNode();
return TQDomNode( IMPL->namedItem( name ) );
}
/*!
Inserts the node \a newNode into the named node map. The name used
by the map is the node name of \a newNode as returned by
TQDomNode::nodeName().
If the new node replaces an existing node, i.e. the map contains a
node with the same name, the replaced node is returned.
\sa namedItem() removeNamedItem() setNamedItemNS()
*/
TQDomNode TQDomNamedNodeMap::setNamedItem( const TQDomNode& newNode )
{
if ( !impl )
return TQDomNode();
return TQDomNode( IMPL->setNamedItem( (TQDomNodePrivate*)newNode.impl ) );
}
/*!
Removes the node called \a name from the map.
The function returns the removed node or a \link
TQDomNode::isNull() null node\endlink if the map did not contain a
node called \a name.
\sa setNamedItem() namedItem() removeNamedItemNS()
*/
TQDomNode TQDomNamedNodeMap::removeNamedItem( const TQString& name )
{
if ( !impl )
return TQDomNode();
return TQDomNode( IMPL->removeNamedItem( name ) );
}
/*!
Retrieves the node at position \a index.
This can be used to iterate over the map. Note that the nodes in
the map are ordered arbitrarily.
\sa length()
*/
TQDomNode TQDomNamedNodeMap::item( int index ) const
{
if ( !impl )
return TQDomNode();
return TQDomNode( IMPL->item( index ) );
}
/*!
Returns the node associated with the local name \a localName and
the namespace URI \a nsURI.
If the map does not contain such a node, a \link
TQDomNode::isNull() null node\endlink is returned.
\sa setNamedItemNS() namedItem()
*/
TQDomNode TQDomNamedNodeMap::namedItemNS( const TQString& nsURI, const TQString& localName ) const
{
if ( !impl )
return TQDomNode();
return TQDomNode( IMPL->namedItemNS( nsURI, localName ) );
}
/*!
Inserts the node \a newNode in the map. If a node with the same
namespace URI and the same local name already exists in the map,
it is replaced by \a newNode. If the new node replaces an existing
node, the replaced node is returned.
\sa namedItemNS() removeNamedItemNS() setNamedItem()
*/
TQDomNode TQDomNamedNodeMap::setNamedItemNS( const TQDomNode& newNode )
{
if ( !impl )
return TQDomNode();
return TQDomNode( IMPL->setNamedItemNS( (TQDomNodePrivate*)newNode.impl ) );
}
/*!
Removes the node with the local name \a localName and the
namespace URI \a nsURI from the map.
The function returns the removed node or a \link
TQDomNode::isNull() null node\endlink if the map did not contain a
node with the local name \a localName and the namespace URI \a
nsURI.
\sa setNamedItemNS() namedItemNS() removeNamedItem()
*/
TQDomNode TQDomNamedNodeMap::removeNamedItemNS( const TQString& nsURI, const TQString& localName )
{
if ( !impl )
return TQDomNode();
TQDomNodePrivate *n = IMPL->namedItemNS( nsURI, localName );
if ( !n )
return TQDomNode();
return TQDomNode( IMPL->removeNamedItem( n->name ) );
}
/*!
Returns the number of nodes in the map.
\sa item()
*/
uint TQDomNamedNodeMap::length() const
{
if ( !impl )
return 0;
return IMPL->length();
}
/*!
\fn uint TQDomNamedNodeMap::count() const
Returns the number of nodes in the map.
This function is the same as length().
*/
/*!
Returns TRUE if the map contains a node called \a name; otherwise
returns FALSE.
*/
bool TQDomNamedNodeMap::contains( const TQString& name ) const
{
if ( !impl )
return FALSE;
return IMPL->contains( name );
}
#undef IMPL
/**************************************************************
*
* TQDomDocumentTypePrivate
*
**************************************************************/
TQDomDocumentTypePrivate::TQDomDocumentTypePrivate( TQDomDocumentPrivate* doc, TQDomNodePrivate* parent )
: TQDomNodePrivate( doc, parent )
{
init();
}
TQDomDocumentTypePrivate::TQDomDocumentTypePrivate( TQDomDocumentTypePrivate* n, bool deep )
: TQDomNodePrivate( n, deep )
{
init();
// Refill the maps with our new children
TQDomNodePrivate* p = first;
while ( p ) {
if ( p->isEntity() )
// Dont use normal insert function since we would create infinite recursion
entities->map.insert( p->nodeName(), p );
if ( p->isNotation() )
// Dont use normal insert function since we would create infinite recursion
notations->map.insert( p->nodeName(), p );
}
}
TQDomDocumentTypePrivate::~TQDomDocumentTypePrivate()
{
if ( entities->deref() )
delete entities;
if ( notations->deref() )
delete notations;
}
void TQDomDocumentTypePrivate::init()
{
entities = new TQDomNamedNodeMapPrivate( this );
notations = new TQDomNamedNodeMapPrivate( this );
publicId = TQString::null;
systemId = TQString::null;
internalSubset = TQString::null;
entities->setAppendToParent( TRUE );
notations->setAppendToParent( TRUE );
}
TQDomNodePrivate* TQDomDocumentTypePrivate::cloneNode( bool deep)
{
TQDomNodePrivate* p = new TQDomDocumentTypePrivate( this, deep );
// We are not interested in this node
p->deref();
return p;
}
TQDomNodePrivate* TQDomDocumentTypePrivate::insertBefore( TQDomNodePrivate* newChild, TQDomNodePrivate* refChild )
{
// Call the origianl implementation
TQDomNodePrivate* p = TQDomNodePrivate::insertBefore( newChild, refChild );
// Update the maps
if ( p && p->isEntity() )
entities->map.insert( p->nodeName(), p );
else if ( p && p->isNotation() )
notations->map.insert( p->nodeName(), p );
return p;
}
TQDomNodePrivate* TQDomDocumentTypePrivate::insertAfter( TQDomNodePrivate* newChild, TQDomNodePrivate* refChild )
{
// Call the origianl implementation
TQDomNodePrivate* p = TQDomNodePrivate::insertAfter( newChild, refChild );
// Update the maps
if ( p && p->isEntity() )
entities->map.insert( p->nodeName(), p );
else if ( p && p->isNotation() )
notations->map.insert( p->nodeName(), p );
return p;
}
TQDomNodePrivate* TQDomDocumentTypePrivate::replaceChild( TQDomNodePrivate* newChild, TQDomNodePrivate* oldChild )
{
// Call the origianl implementation
TQDomNodePrivate* p = TQDomNodePrivate::replaceChild( newChild, oldChild );
// Update the maps
if ( p ) {
if ( oldChild && oldChild->isEntity() )
entities->map.remove( oldChild->nodeName() );
else if ( oldChild && oldChild->isNotation() )
notations->map.remove( oldChild->nodeName() );
if ( p->isEntity() )
entities->map.insert( p->nodeName(), p );
else if ( p->isNotation() )
notations->map.insert( p->nodeName(), p );
}
return p;
}
TQDomNodePrivate* TQDomDocumentTypePrivate::removeChild( TQDomNodePrivate* oldChild )
{
// Call the origianl implementation
TQDomNodePrivate* p = TQDomNodePrivate::removeChild( oldChild );
// Update the maps
if ( p && p->isEntity() )
entities->map.remove( p->nodeName() );
else if ( p && p->isNotation() )
notations->map.remove( p ->nodeName() );
return p;
}
TQDomNodePrivate* TQDomDocumentTypePrivate::appendChild( TQDomNodePrivate* newChild )
{
return insertAfter( newChild, 0 );
}
void TQDomDocumentTypePrivate::save( TQTextStream& s, int, int indent ) const
{
if ( name.isEmpty() )
return;
s << "<!DOCTYPE " << name;
if ( !publicId.isNull() ) {
s << " PUBLIC \"" << publicId << "\"";
if ( !systemId.isNull() )
s << " \"" << systemId << "\"";
} else if ( !systemId.isNull() ) {
s << " SYSTEM \"" << systemId << "\"";
}
if ( entities->length()>0 || notations->length()>0 ) {
s << " [ " << endl;
TQDictIterator<TQDomNodePrivate> it2( notations->map );
for ( ; it2.current(); ++it2 )
it2.current()->save( s, 0, indent );
TQDictIterator<TQDomNodePrivate> it( entities->map );
for ( ; it.current(); ++it )
it.current()->save( s, 0, indent );
s << " ]";
}
s << ">" << endl;
}
/**************************************************************
*
* TQDomDocumentType
*
**************************************************************/
#define IMPL ((TQDomDocumentTypePrivate*)impl)
/*!
\class TQDomDocumentType ntqdom.h
\reentrant
\brief The TQDomDocumentType class is the representation of the DTD
in the document tree.
\if defined(commercial)
It is part of the <a href="commercialeditions.html">TQt Enterprise Edition</a>.
\endif
\module XML
\ingroup xml-tools
The TQDomDocumentType class allows read-only access to some of the
data structures in the DTD: it can return a map of all entities()
and notations(). In addition the function name() returns the name
of the document type as specified in the <!DOCTYPE name>
tag. This class also provides the publicId(), systemId() and
internalSubset() functions.
\sa TQDomDocument
*/
/*!
Creates an empty TQDomDocumentType object.
*/
TQDomDocumentType::TQDomDocumentType() : TQDomNode()
{
}
/*!
Constructs a copy of \a n.
The data of the copy is shared (shallow copy): modifying one node
will also change the other. If you want to make a deep copy, use
cloneNode().
*/
TQDomDocumentType::TQDomDocumentType( const TQDomDocumentType& n )
: TQDomNode( n )
{
}
TQDomDocumentType::TQDomDocumentType( TQDomDocumentTypePrivate* n )
: TQDomNode( n )
{
}
/*!
Assigns \a n to this document type.
The data of the copy is shared (shallow copy): modifying one node
will also change the other. If you want to make a deep copy, use
cloneNode().
*/
TQDomDocumentType& TQDomDocumentType::operator= ( const TQDomDocumentType& n )
{
return (TQDomDocumentType&) TQDomNode::operator=( n );
}
/*!
Destroys the object and frees its resources.
*/
TQDomDocumentType::~TQDomDocumentType()
{
}
/*!
Returns the name of the document type as specified in the
<!DOCTYPE name> tag.
\sa nodeName()
*/
TQString TQDomDocumentType::name() const
{
if ( !impl )
return TQString::null;
return IMPL->nodeName();
}
/*!
Returns a map of all entities described in the DTD.
*/
TQDomNamedNodeMap TQDomDocumentType::entities() const
{
if ( !impl )
return TQDomNamedNodeMap();
return TQDomNamedNodeMap( IMPL->entities );
}
/*!
Returns a map of all notations described in the DTD.
*/
TQDomNamedNodeMap TQDomDocumentType::notations() const
{
if ( !impl )
return TQDomNamedNodeMap();
return TQDomNamedNodeMap( IMPL->notations );
}
/*!
Returns the public identifier of the external DTD subset or
TQString::null if there is no public identifier.
\sa systemId() internalSubset() TQDomImplementation::createDocumentType()
*/
TQString TQDomDocumentType::publicId() const
{
if ( !impl )
return TQString::null;
return IMPL->publicId;
}
/*!
Returns the system identifier of the external DTD subset or
TQString::null if there is no system identifier.
\sa publicId() internalSubset() TQDomImplementation::createDocumentType()
*/
TQString TQDomDocumentType::systemId() const
{
if ( !impl )
return TQString::null;
return IMPL->systemId;
}
/*!
Returns the internal subset of the document type or TQString::null
if there is no internal subset.
\sa publicId() systemId()
*/
TQString TQDomDocumentType::internalSubset() const
{
if ( !impl )
return TQString::null;
return IMPL->internalSubset;
}
/*!
Returns \c DocumentTypeNode.
\sa isDocumentType() TQDomNode::toDocumentType()
*/
TQDomNode::NodeType TQDomDocumentType::nodeType() const
{
return DocumentTypeNode;
}
/*!
This function overloads TQDomNode::isDocumentType().
\sa nodeType() TQDomNode::toDocumentType()
*/
bool TQDomDocumentType::isDocumentType() const
{
return TRUE;
}
#undef IMPL
/**************************************************************
*
* TQDomDocumentFragmentPrivate
*
**************************************************************/
TQDomDocumentFragmentPrivate::TQDomDocumentFragmentPrivate( TQDomDocumentPrivate* doc, TQDomNodePrivate* parent )
: TQDomNodePrivate( doc, parent )
{
name = "#document-fragment";
}
TQDomDocumentFragmentPrivate::TQDomDocumentFragmentPrivate( TQDomNodePrivate* n, bool deep )
: TQDomNodePrivate( n, deep )
{
}
TQDomDocumentFragmentPrivate::~TQDomDocumentFragmentPrivate()
{
}
TQDomNodePrivate* TQDomDocumentFragmentPrivate::cloneNode( bool deep)
{
TQDomNodePrivate* p = new TQDomDocumentFragmentPrivate( this, deep );
// We are not interested in this node
p->deref();
return p;
}
/**************************************************************
*
* TQDomDocumentFragment
*
**************************************************************/
#define IMPL ((TQDomDocumentFragmentPrivate*)impl)
/*!
\class TQDomDocumentFragment ntqdom.h
\reentrant
\brief The TQDomDocumentFragment class is a tree of TQDomNodes which is not usually a complete TQDomDocument.
\if defined(commercial)
It is part of the <a href="commercialeditions.html">TQt Enterprise Edition</a>.
\endif
\module XML
\ingroup xml-tools
If you want to do complex tree operations it is useful to have a
lightweight class to store nodes and their relations.
TQDomDocumentFragment stores a subtree of a document which does not
necessarily represent a well-formed XML document.
TQDomDocumentFragment is also useful if you want to group several
nodes in a list and insert them all together as children of some
node. In these cases TQDomDocumentFragment can be used as a
temporary container for this list of children.
The most important feature of TQDomDocumentFragment is that it is
treated in a special way by TQDomNode::insertAfter(),
TQDomNode::insertBefore(), TQDomNode::replaceChild() and
TQDomNode::appendChild(): instead of inserting the fragment itself, all
the fragment's children are inserted.
*/
/*!
Constructs an empty document fragment.
*/
TQDomDocumentFragment::TQDomDocumentFragment()
{
}
TQDomDocumentFragment::TQDomDocumentFragment( TQDomDocumentFragmentPrivate* n )
: TQDomNode( n )
{
}
/*!
Constructs a copy of \a x.
The data of the copy is shared (shallow copy): modifying one node
will also change the other. If you want to make a deep copy, use
cloneNode().
*/
TQDomDocumentFragment::TQDomDocumentFragment( const TQDomDocumentFragment& x )
: TQDomNode( x )
{
}
/*!
Assigns \a x to this DOM document fragment.
The data of the copy is shared (shallow copy): modifying one node
will also change the other. If you want to make a deep copy, use
cloneNode().
*/
TQDomDocumentFragment& TQDomDocumentFragment::operator= ( const TQDomDocumentFragment& x )
{
return (TQDomDocumentFragment&) TQDomNode::operator=( x );
}
/*!
Destroys the object and frees its resources.
*/
TQDomDocumentFragment::~TQDomDocumentFragment()
{
}
/*!
Returns \c DocumentFragment.
\sa isDocumentFragment() TQDomNode::toDocumentFragment()
*/
TQDomNode::NodeType TQDomDocumentFragment::nodeType() const
{
return TQDomNode::DocumentFragmentNode;
}
/*!
This function reimplements TQDomNode::isDocumentFragment().
\sa nodeType() TQDomNode::toDocumentFragment()
*/
bool TQDomDocumentFragment::isDocumentFragment() const
{
return TRUE;
}
#undef IMPL
/**************************************************************
*
* TQDomCharacterDataPrivate
*
**************************************************************/
TQDomCharacterDataPrivate::TQDomCharacterDataPrivate( TQDomDocumentPrivate* d, TQDomNodePrivate* p,
const TQString& data )
: TQDomNodePrivate( d, p )
{
value = data;
name = "#character-data";
}
TQDomCharacterDataPrivate::TQDomCharacterDataPrivate( TQDomCharacterDataPrivate* n, bool deep )
: TQDomNodePrivate( n, deep )
{
}
TQDomCharacterDataPrivate::~TQDomCharacterDataPrivate()
{
}
TQDomNodePrivate* TQDomCharacterDataPrivate::cloneNode( bool deep )
{
TQDomNodePrivate* p = new TQDomCharacterDataPrivate( this, deep );
// We are not interested in this node
p->deref();
return p;
}
uint TQDomCharacterDataPrivate::dataLength() const
{
return value.length();
}
TQString TQDomCharacterDataPrivate::substringData( unsigned long offset, unsigned long n ) const
{
return value.mid( offset, n );
}
void TQDomCharacterDataPrivate::insertData( unsigned long offset, const TQString& arg )
{
value.insert( offset, arg );
}
void TQDomCharacterDataPrivate::deleteData( unsigned long offset, unsigned long n )
{
value.remove( offset, n );
}
void TQDomCharacterDataPrivate::replaceData( unsigned long offset, unsigned long n, const TQString& arg )
{
value.replace( offset, n, arg );
}
void TQDomCharacterDataPrivate::appendData( const TQString& arg )
{
value += arg;
}
/**************************************************************
*
* TQDomCharacterData
*
**************************************************************/
#define IMPL ((TQDomCharacterDataPrivate*)impl)
/*!
\class TQDomCharacterData ntqdom.h
\reentrant
\brief The TQDomCharacterData class represents a generic string in the DOM.
\if defined(commercial)
It is part of the <a href="commercialeditions.html">TQt Enterprise Edition</a>.
\endif
\module XML
\ingroup xml-tools
Character data as used in XML specifies a generic data string.
More specialized versions of this class are TQDomText, TQDomComment
and TQDomCDATASection.
The data string is set with setData() and retrieved with data().
You can retrieve a portion of the data string using
substringData(). Extra data can be appended with appendData(), or
inserted with insertData(). Portions of the data string can be
deleted with deleteData() or replaced with replaceData(). The
length of the data string is returned by length().
The node type of the node containing this character data is
returned by nodeType().
\sa TQDomText TQDomComment TQDomCDATASection
*/
/*!
Constructs an empty character data object.
*/
TQDomCharacterData::TQDomCharacterData()
{
}
/*!
Constructs a copy of \a x.
The data of the copy is shared (shallow copy): modifying one node
will also change the other. If you want to make a deep copy, use
cloneNode().
*/
TQDomCharacterData::TQDomCharacterData( const TQDomCharacterData& x )
: TQDomNode( x )
{
}
TQDomCharacterData::TQDomCharacterData( TQDomCharacterDataPrivate* n )
: TQDomNode( n )
{
}
/*!
Assigns \a x to this character data.
The data of the copy is shared (shallow copy): modifying one node
will also change the other. If you want to make a deep copy, use
cloneNode().
*/
TQDomCharacterData& TQDomCharacterData::operator= ( const TQDomCharacterData& x )
{
return (TQDomCharacterData&) TQDomNode::operator=( x );
}
/*!
Destroys the object and frees its resources.
*/
TQDomCharacterData::~TQDomCharacterData()
{
}
/*!
Returns the string stored in this object.
If the node is a \link isNull() null node\endlink, it will return
TQString::null.
*/
TQString TQDomCharacterData::data() const
{
if ( !impl )
return TQString::null;
return impl->nodeValue();
}
/*!
Sets this object's string to \a v.
*/
void TQDomCharacterData::setData( const TQString& v )
{
if ( impl )
impl->setNodeValue( v );
}
/*!
Returns the length of the stored string.
*/
uint TQDomCharacterData::length() const
{
if ( impl )
return IMPL->dataLength();
return 0;
}
/*!
Returns the substring of length \a count from position \a offset.
*/
TQString TQDomCharacterData::substringData( unsigned long offset, unsigned long count )
{
if ( !impl )
return TQString::null;
return IMPL->substringData( offset, count );
}
/*!
Appends the string \a arg to the stored string.
*/
void TQDomCharacterData::appendData( const TQString& arg )
{
if ( impl )
IMPL->appendData( arg );
}
/*!
Inserts the string \a arg into the stored string at position \a offset.
*/
void TQDomCharacterData::insertData( unsigned long offset, const TQString& arg )
{
if ( impl )
IMPL->insertData( offset, arg );
}
/*!
Deletes a substring of length \a count from position \a offset.
*/
void TQDomCharacterData::deleteData( unsigned long offset, unsigned long count )
{
if ( impl )
IMPL->deleteData( offset, count );
}
/*!
Replaces the substring of length \a count starting at position \a
offset with the string \a arg.
*/
void TQDomCharacterData::replaceData( unsigned long offset, unsigned long count, const TQString& arg )
{
if ( impl )
IMPL->replaceData( offset, count, arg );
}
/*!
Returns the type of node this object refers to (i.e. \c TextNode,
\c CDATASectionNode, \c CommentNode or \c CharacterDataNode). For
a \link isNull() null node\endlink \c CharacterDataNode is
returned.
*/
TQDomNode::NodeType TQDomCharacterData::nodeType() const
{
if( !impl )
return CharacterDataNode;
return TQDomNode::nodeType();
}
/*!
Returns TRUE.
*/
bool TQDomCharacterData::isCharacterData() const
{
return TRUE;
}
#undef IMPL
/**************************************************************
*
* TQDomAttrPrivate
*
**************************************************************/
TQDomAttrPrivate::TQDomAttrPrivate( TQDomDocumentPrivate* d, TQDomNodePrivate* parent, const TQString& name_ )
: TQDomNodePrivate( d, parent )
{
name = name_;
m_specified = FALSE;
}
TQDomAttrPrivate::TQDomAttrPrivate( TQDomDocumentPrivate* d, TQDomNodePrivate* p, const TQString& nsURI, const TQString& qName )
: TQDomNodePrivate( d, p )
{
qt_split_namespace( prefix, name, qName, !nsURI.isNull() );
namespaceURI = nsURI;
createdWithDom1Interface = FALSE;
m_specified = FALSE;
}
TQDomAttrPrivate::TQDomAttrPrivate( TQDomAttrPrivate* n, bool deep )
: TQDomNodePrivate( n, deep )
{
m_specified = n->specified();
}
TQDomAttrPrivate::~TQDomAttrPrivate()
{
}
void TQDomAttrPrivate::setNodeValue( const TQString& v )
{
value = v;
TQDomTextPrivate *t = new TQDomTextPrivate( 0, this, v );
// keep the refcount balanced: appendChild() does a ref() anyway.
t->deref();
if ( first ) {
delete removeChild( first );
}
appendChild( t );
}
TQDomNodePrivate* TQDomAttrPrivate::cloneNode( bool deep )
{
TQDomNodePrivate* p = new TQDomAttrPrivate( this, deep );
// We are not interested in this node
p->deref();
return p;
}
bool TQDomAttrPrivate::specified() const
{
return m_specified;
}
static bool isXmlChar(const TQChar &c)
{
// Characters in this range must be accepted by XML parsers.
// Consequently characters outside of this range need to be escaped.
ushort uc = c.unicode();
return uc == 0x9
|| uc == 0xA
|| uc == 0xD
|| ( 0x20 <= uc && uc <= 0xD7FF )
|| ( 0xE000 <= uc && uc <= 0xFFFD );
}
/*
Encode an attribute value upon saving.
*/
static TQString encodeAttr( const TQString& str )
{
TQString tmp( str );
uint len = tmp.length();
uint i = 0;
while ( i < len ) {
if ( tmp[(int)i] == '<' ) {
tmp.replace( i, 1, "<" );
len += 3;
i += 4;
} else if ( tmp[(int)i] == '"' ) {
tmp.replace( i, 1, """ );
len += 5;
i += 6;
} else if ( tmp[(int)i] == '&' ) {
tmp.replace( i, 1, "&" );
len += 4;
i += 5;
} else if ( tmp[(int)i] == '>' && i>=2 && tmp[(int)i-1]==']' && tmp[(int)i-2]==']' ) {
tmp.replace( i, 1, ">" );
len += 3;
i += 4;
} else if (!isXmlChar(tmp[(int)i])) {
TQString repl = "&#x" + TQString::number(tmp[(int)i].unicode(), 16) + ';';
tqWarning("TQDom: saving invalid character %s, the document will not be well-formed", repl.latin1());
tmp.replace(i, 1, repl);
len += repl.length() - 1;
i += repl.length();
} else {
++i;
}
}
return tmp;
}
void TQDomAttrPrivate::save( TQTextStream& s, int, int ) const
{
if ( namespaceURI.isNull() ) {
s << name << "=\"" << encodeAttr( value ) << "\"";
} else {
// ### optimize this (see comment of TQDomElementPrivate::save()
s << prefix << ":" << name << "=\"" << encodeAttr( value ) << "\""
<< " xmlns:" << prefix << "=\"" << encodeAttr( namespaceURI ) << "\"";
}
}
/**************************************************************
*
* TQDomAttr
*
**************************************************************/
#define IMPL ((TQDomAttrPrivate*)impl)
/*!
\class TQDomAttr ntqdom.h
\reentrant
\brief The TQDomAttr class represents one attribute of a TQDomElement.
\if defined(commercial)
It is part of the <a href="commercialeditions.html">TQt Enterprise Edition</a>.
\endif
\module XML
\ingroup xml-tools
For example, the following piece of XML produces an element with
no children, but two attributes:
\code
<link href="http://www.trolltech.com" color="red" />
\endcode
You can access the attributes of an element with code like this:
\code
TQDomElement e = //...
//...
TQDomAttr a = e.attributeNode( "href" );
cout << a.value() << endl; // prints "http://www.trolltech.com"
a.setValue( "http://doc.trolltech.com" ); // change the node's attribute
TQDomAttr a2 = e.attributeNode( "href" );
cout << a2.value() << endl; // prints "http://doc.trolltech.com"
\endcode
This example also shows that changing an attribute received from
an element changes the attribute of the element. If you do not
want to change the value of the element's attribute you must
use cloneNode() to get an independent copy of the attribute.
TQDomAttr can return the name() and value() of an attribute. An
attribute's value is set with setValue(). If specified() returns
TRUE the value was either set in the document or set with
setValue(); otherwise the value hasn't been set. The node this
attribute is attached to (if any) is returned by ownerElement().
For further information about the Document Object Model see
\link http://www.w3.org/TR/REC-DOM-Level-1/\endlink and
\link http://www.w3.org/TR/DOM-Level-2-Core/\endlink.
For a more general introduction of the DOM implementation see the
TQDomDocument documentation.
*/
/*!
Constructs an empty attribute.
*/
TQDomAttr::TQDomAttr()
{
}
/*!
Constructs a copy of \a x.
The data of the copy is shared (shallow copy): modifying one node
will also change the other. If you want to make a deep copy, use
cloneNode().
*/
TQDomAttr::TQDomAttr( const TQDomAttr& x )
: TQDomNode( x )
{
}
TQDomAttr::TQDomAttr( TQDomAttrPrivate* n )
: TQDomNode( n )
{
}
/*!
Assigns \a x to this DOM attribute.
The data of the copy is shared (shallow copy): modifying one node
will also change the other. If you want to make a deep copy, use
cloneNode().
*/
TQDomAttr& TQDomAttr::operator= ( const TQDomAttr& x )
{
return (TQDomAttr&) TQDomNode::operator=( x );
}
/*!
Destroys the object and frees its resources.
*/
TQDomAttr::~TQDomAttr()
{
}
/*!
Returns the attribute's name.
*/
TQString TQDomAttr::name() const
{
if ( !impl )
return TQString::null;
return impl->nodeName();
}
/*!
Returns TRUE if the attribute has either been expicitly specified
in the XML document or was set by the user with setValue().
Returns FALSE if the value hasn't been specified or set.
\sa setValue()
*/
bool TQDomAttr::specified() const
{
if ( !impl )
return FALSE;
return IMPL->specified();
}
/*!
Returns the element node this attribute is attached to or a \link
TQDomNode::isNull() null node\endlink if this attribute is not
attached to any element.
*/
TQDomElement TQDomAttr::ownerElement() const
{
if ( !impl && !impl->parent()->isElement() )
return TQDomElement();
return TQDomElement( (TQDomElementPrivate*)(impl->parent()) );
}
/*!
Returns the value of the attribute or TQString::null if the
attribute has not been specified.
\sa specified() setValue()
*/
TQString TQDomAttr::value() const
{
if ( !impl )
return TQString::null;
return impl->nodeValue();
}
/*!
Sets the attribute's value to \a v.
\sa value()
*/
void TQDomAttr::setValue( const TQString& v )
{
if ( !impl )
return;
impl->setNodeValue( v );
IMPL->m_specified = TRUE;
}
/*!
Returns \link TQDomNode::NodeType AttributeNode\endlink.
*/
TQDomNode::NodeType TQDomAttr::nodeType() const
{
return AttributeNode;
}
/*!
Returns TRUE.
*/
bool TQDomAttr::isAttr() const
{
return TRUE;
}
#undef IMPL
/**************************************************************
*
* TQDomElementPrivate
*
**************************************************************/
TQDomElementPrivate::TQDomElementPrivate( TQDomDocumentPrivate* d, TQDomNodePrivate* p,
const TQString& tagname )
: TQDomNodePrivate( d, p )
{
name = tagname;
m_attr = new TQDomNamedNodeMapPrivate( this );
}
TQDomElementPrivate::TQDomElementPrivate( TQDomDocumentPrivate* d, TQDomNodePrivate* p,
const TQString& nsURI, const TQString& qName )
: TQDomNodePrivate( d, p )
{
qt_split_namespace( prefix, name, qName, !nsURI.isNull() );
namespaceURI = nsURI;
createdWithDom1Interface = FALSE;
m_attr = new TQDomNamedNodeMapPrivate( this );
}
TQDomElementPrivate::TQDomElementPrivate( TQDomElementPrivate* n, bool deep ) :
TQDomNodePrivate( n, deep )
{
m_attr = n->m_attr->clone( this );
// Reference is down to 0, so we set it to 1 here.
m_attr->ref();
}
TQDomElementPrivate::~TQDomElementPrivate()
{
if ( m_attr->deref() )
delete m_attr;
}
TQDomNodePrivate* TQDomElementPrivate::cloneNode( bool deep)
{
TQDomNodePrivate* p = new TQDomElementPrivate( this, deep );
// We are not interested in this node
p->deref();
return p;
}
TQString TQDomElementPrivate::attribute( const TQString& name_, const TQString& defValue ) const
{
TQDomNodePrivate* n = m_attr->namedItem( name_ );
if ( !n )
return defValue;
return n->nodeValue();
}
TQString TQDomElementPrivate::attributeNS( const TQString& nsURI, const TQString& localName, const TQString& defValue ) const
{
TQDomNodePrivate* n = m_attr->namedItemNS( nsURI, localName );
if ( !n )
return defValue;
return n->nodeValue();
}
void TQDomElementPrivate::setAttribute( const TQString& aname, const TQString& newValue )
{
TQDomNodePrivate* n = m_attr->namedItem( aname );
if ( !n ) {
n = new TQDomAttrPrivate( ownerDocument(), this, aname );
n->setNodeValue( newValue );
// Referencing is done by the map, so we set the reference counter back
// to 0 here. This is ok since we created the TQDomAttrPrivate.
n->deref();
m_attr->setNamedItem( n );
} else {
n->setNodeValue( newValue );
}
}
void TQDomElementPrivate::setAttributeNS( const TQString& nsURI, const TQString& qName, const TQString& newValue )
{
TQString prefix, localName;
qt_split_namespace( prefix, localName, qName, TRUE );
TQDomNodePrivate* n = m_attr->namedItemNS( nsURI, localName );
if ( !n ) {
n = new TQDomAttrPrivate( ownerDocument(), this, nsURI, qName );
n->setNodeValue( newValue );
// Referencing is done by the map, so we set the reference counter back
// to 0 here. This is ok since we created the TQDomAttrPrivate.
n->deref();
m_attr->setNamedItem( n );
} else {
n->setNodeValue( newValue );
n->prefix = prefix;
}
}
void TQDomElementPrivate::removeAttribute( const TQString& aname )
{
TQDomNodePrivate* p = m_attr->removeNamedItem( aname );
if ( p && p->count == 0 )
delete p;
}
TQDomAttrPrivate* TQDomElementPrivate::attributeNode( const TQString& aname )
{
return (TQDomAttrPrivate*)m_attr->namedItem( aname );
}
TQDomAttrPrivate* TQDomElementPrivate::attributeNodeNS( const TQString& nsURI, const TQString& localName )
{
return (TQDomAttrPrivate*)m_attr->namedItemNS( nsURI, localName );
}
TQDomAttrPrivate* TQDomElementPrivate::setAttributeNode( TQDomAttrPrivate* newAttr )
{
TQDomNodePrivate* n = m_attr->namedItem( newAttr->nodeName() );
// Referencing is done by the maps
m_attr->setNamedItem( newAttr );
return (TQDomAttrPrivate*)n;
}
TQDomAttrPrivate* TQDomElementPrivate::setAttributeNodeNS( TQDomAttrPrivate* newAttr )
{
TQDomNodePrivate* n = 0;
if ( !newAttr->prefix.isNull() )
n = m_attr->namedItemNS( newAttr->namespaceURI, newAttr->name );
// Referencing is done by the maps
m_attr->setNamedItem( newAttr );
return (TQDomAttrPrivate*)n;
}
TQDomAttrPrivate* TQDomElementPrivate::removeAttributeNode( TQDomAttrPrivate* oldAttr )
{
return (TQDomAttrPrivate*)m_attr->removeNamedItem( oldAttr->nodeName() );
}
bool TQDomElementPrivate::hasAttribute( const TQString& aname )
{
return m_attr->contains( aname );
}
bool TQDomElementPrivate::hasAttributeNS( const TQString& nsURI, const TQString& localName )
{
return m_attr->containsNS( nsURI, localName );
}
TQString TQDomElementPrivate::text()
{
TQString t( "" );
TQDomNodePrivate* p = first;
while ( p ) {
if ( p->isText() || p->isCDATASection() )
t += p->nodeValue();
else if ( p->isElement() )
t += ((TQDomElementPrivate*)p)->text();
p = p->next;
}
return t;
}
void TQDomElementPrivate::save( TQTextStream& s, int depth, int indent ) const
{
if ( !( prev && prev->isText() ) )
for ( int i = 0; i < depth*indent; ++i )
s << " ";
TQString qName( name );
TQString nsDecl( "" );
if ( !namespaceURI.isNull() ) {
// ### optimize this, so that you only declare namespaces that are not
// yet declared -- we loose default namespace mappings, so maybe we
// should rather store the information that we get from
// startPrefixMapping()/endPrefixMapping() and use them (you have to
// take care if the DOM tree is modified, though)
if ( prefix.isEmpty() ) {
nsDecl = " xmlns";
} else {
qName = prefix + ":" + name;
nsDecl = " xmlns:" + prefix;
}
nsDecl += "=\"" + encodeAttr( namespaceURI ) + "\"";
}
s << "<" << qName << nsDecl;
if ( !m_attr->map.isEmpty() ) {
s << " ";
TQDictIterator<TQDomNodePrivate> it( m_attr->map );
for ( ; it.current(); ++it ) {
it.current()->save( s, 0, indent );
s << " ";
}
}
if ( last ) {
// has child nodes
if ( first->isText() )
s << ">";
else
s << ">" << endl;
TQDomNodePrivate::save( s, depth + 1, indent);
if ( !last->isText() )
for( int i = 0; i < depth*indent; ++i )
s << " ";
s << "</" << qName << ">";
} else {
s << "/>";
}
if ( !( next && next->isText() ) )
s << endl;
}
/**************************************************************
*
* TQDomElement
*
**************************************************************/
#define IMPL ((TQDomElementPrivate*)impl)
/*!
\class TQDomElement ntqdom.h
\reentrant
\brief The TQDomElement class represents one element in the DOM tree.
\if defined(commercial)
It is part of the <a href="commercialeditions.html">TQt Enterprise Edition</a>.
\endif
\module XML
\ingroup xml-tools
Elements have a tagName() and zero or more attributes associated
with them. The tag name can be changed with setTagName().
Element attributes are represented by TQDomAttr objects that can
be queried using the attribute() and attributeNode() functions.
You can set attributes with the setAttribute() and
setAttributeNode() functions. Attributes can be removed with
removeAttribute(). There are namespace-aware equivalents to these
functions, i.e. setAttributeNS(), setAttributeNodeNS() and
removeAttributeNS().
If you want to access the text of a node use text(), e.g.
\code
TQDomElement e = //...
//...
TQString s = e.text()
\endcode
The text() function operates recursively to find the text (since
not all elements contain text). If you want to find all the text
in all of a node's children, iterate over the children looking for
TQDomText nodes, e.g.
\code
TQString text;
TQDomElement element = doc.documentElement();
for( TQDomNode n = element.firstChild(); !n.isNull(); n = n.nextSibling() )
{
TQDomText t = n.toText();
if ( !t.isNull() )
text += t.data();
}
\endcode
Note that we attempt to convert each node to a text node and use
text() rather than using firstChild().toText().data() or
n.toText().data() directly on the node, because the node may not
be a text element.
You can get a list of all the decendents of an element which have
a specified tag name with elementsByTagName() or
elementsByTagNameNS().
For further information about the Document Object Model see
\link http://www.w3.org/TR/REC-DOM-Level-1/\endlink and
\link http://www.w3.org/TR/DOM-Level-2-Core/\endlink.
For a more general introduction of the DOM implementation see the
TQDomDocument documentation.
*/
/*!
Constructs an empty element. Use the TQDomDocument::createElement()
function to construct elements with content.
*/
TQDomElement::TQDomElement()
: TQDomNode()
{
}
/*!
Constructs a copy of \a x.
The data of the copy is shared (shallow copy): modifying one node
will also change the other. If you want to make a deep copy, use
cloneNode().
*/
TQDomElement::TQDomElement( const TQDomElement& x )
: TQDomNode( x )
{
}
TQDomElement::TQDomElement( TQDomElementPrivate* n )
: TQDomNode( n )
{
}
/*!
Assigns \a x to this DOM element.
The data of the copy is shared (shallow copy): modifying one node
will also change the other. If you want to make a deep copy, use
cloneNode().
*/
TQDomElement& TQDomElement::operator= ( const TQDomElement& x )
{
return (TQDomElement&) TQDomNode::operator=( x );
}
/*!
Destroys the object and frees its resources.
*/
TQDomElement::~TQDomElement()
{
}
/*!
Returns \c ElementNode.
*/
TQDomNode::NodeType TQDomElement::nodeType() const
{
return ElementNode;
}
/*!
Sets this element's tag name to \a name.
\sa tagName()
*/
void TQDomElement::setTagName( const TQString& name )
{
if ( impl )
impl->name = name;
}
/*!
Returns the tag name of this element. For an XML element like this:
\code
<img src="myimg.png">
\endcode
the tagname would return "img".
\sa setTagName()
*/
TQString TQDomElement::tagName() const
{
if ( !impl )
return TQString::null;
return impl->nodeName();
}
/*!
Returns the attribute called \a name. If the attribute does not
exist \a defValue is returned.
\sa setAttribute() attributeNode() setAttributeNode() attributeNS()
*/
TQString TQDomElement::attribute( const TQString& name, const TQString& defValue ) const
{
if ( !impl )
return defValue;
return IMPL->attribute( name, defValue );
}
/*!
Adds an attribute called \a name with value \a value. If an
attribute with the same name exists, its value is replaced by \a
value.
\sa attribute() setAttributeNode() setAttributeNS()
*/
void TQDomElement::setAttribute( const TQString& name, const TQString& value )
{
if ( !impl )
return;
IMPL->setAttribute( name, value );
}
/*!
\overload
*/
void TQDomElement::setAttribute( const TQString& name, int value )
{
// ### 4.0: inline
setAttribute( name, long(value) );
}
/*!
\overload
*/
void TQDomElement::setAttribute( const TQString& name, uint value )
{
// ### 4.0: inline
setAttribute( name, ulong(value) );
}
/*!
\overload
*/
void TQDomElement::setAttribute( const TQString& name, long value )
{
if ( !impl )
return;
TQString x;
x.setNum( value );
IMPL->setAttribute( name, x );
}
/*!
\overload
*/
void TQDomElement::setAttribute( const TQString& name, ulong value )
{
if ( !impl )
return;
TQString x;
x.setNum( value );
IMPL->setAttribute( name, x );
}
/*!
\overload
*/
void TQDomElement::setAttribute( const TQString& name, double value )
{
if ( !impl )
return;
TQString x;
x.setNum( value );
IMPL->setAttribute( name, x );
}
/*!
Removes the attribute called name \a name from this element.
\sa setAttribute() attribute() removeAttributeNS()
*/
void TQDomElement::removeAttribute( const TQString& name )
{
if ( !impl )
return;
IMPL->removeAttribute( name );
}
/*!
Returns the TQDomAttr object that corresponds to the attribute
called \a name. If no such attribute exists a \link
TQDomNode::isNull() null attribute\endlink is returned.
\sa setAttributeNode() attribute() setAttribute() attributeNodeNS()
*/
TQDomAttr TQDomElement::attributeNode( const TQString& name)
{
if ( !impl )
return TQDomAttr();
return TQDomAttr( IMPL->attributeNode( name ) );
}
/*!
Adds the attribute \a newAttr to this element.
If the element has another attribute that has the same name as \a
newAttr, this function replaces that attribute and returns it;
otherwise the function returns a \link TQDomNode::isNull() null
attribute\endlink.
\sa attributeNode() setAttribute() setAttributeNodeNS()
*/
TQDomAttr TQDomElement::setAttributeNode( const TQDomAttr& newAttr )
{
if ( !impl )
return TQDomAttr();
return TQDomAttr( IMPL->setAttributeNode( ((TQDomAttrPrivate*)newAttr.impl) ) );
}
/*!
Removes the attribute \a oldAttr from the element and returns it.
\sa attributeNode() setAttributeNode()
*/
TQDomAttr TQDomElement::removeAttributeNode( const TQDomAttr& oldAttr )
{
if ( !impl )
return TQDomAttr(); // ### should this return oldAttr?
return TQDomAttr( IMPL->removeAttributeNode( ((TQDomAttrPrivate*)oldAttr.impl) ) );
}
/*!
Returns a TQDomNodeList containing all descendent elements of this
element that are called \a tagname. The order they are in the node
list is the order they are encountered in a preorder traversal of
the element tree.
\sa elementsByTagNameNS() TQDomDocument::elementsByTagName()
*/
TQDomNodeList TQDomElement::elementsByTagName( const TQString& tagname ) const
{
return TQDomNodeList( new TQDomNodeListPrivate( impl, tagname ) );
}
/*!
Returns TRUE.
*/
bool TQDomElement::isElement() const
{
return TRUE;
}
/*!
Returns a TQDomNamedNodeMap containing all this element's attributes.
\sa attribute() setAttribute() attributeNode() setAttributeNode()
*/
TQDomNamedNodeMap TQDomElement::attributes() const
{
if ( !impl )
return TQDomNamedNodeMap();
return TQDomNamedNodeMap( IMPL->attributes() );
}
/*!
Returns TRUE if this element has an attribute called \a name;
otherwise returns FALSE.
*/
bool TQDomElement::hasAttribute( const TQString& name ) const
{
if ( !impl )
return FALSE;
return IMPL->hasAttribute( name );
}
/*!
Returns the attribute with the local name \a localName and the
namespace URI \a nsURI. If the attribute does not exist \a
defValue is returned.
\sa setAttributeNS() attributeNodeNS() setAttributeNodeNS() attribute()
*/
TQString TQDomElement::attributeNS( const TQString nsURI, const TQString& localName, const TQString& defValue ) const
{
if ( !impl )
return defValue;
return IMPL->attributeNS( nsURI, localName, defValue );
}
/*!
Adds an attribute with the qualified name \a qName and the
namespace URI \a nsURI with the value \a value. If an attribute
with the same local name and namespace URI exists, its prefix is
replaced by the prefix of \a qName and its value is repaced by \a
value.
Although \a qName is the qualified name, the local name is used to
decide if an existing attribute's value should be replaced.
\sa attributeNS() setAttributeNodeNS() setAttribute()
*/
void TQDomElement::setAttributeNS( const TQString nsURI, const TQString& qName, const TQString& value )
{
if ( !impl )
return;
IMPL->setAttributeNS( nsURI, qName, value );
}
/*!
\overload
*/
void TQDomElement::setAttributeNS( const TQString nsURI, const TQString& qName, int value )
{
// ### 4.0: inline
setAttributeNS( nsURI, qName, long(value) );
}
/*!
\overload
*/
void TQDomElement::setAttributeNS( const TQString nsURI, const TQString& qName, uint value )
{
// ### 4.0: inline
setAttributeNS( nsURI, qName, ulong(value) );
}
/*!
\overload
*/
void TQDomElement::setAttributeNS( const TQString nsURI, const TQString& qName, long value )
{
if ( !impl )
return;
TQString x;
x.setNum( value );
IMPL->setAttributeNS( nsURI, qName, x );
}
/*!
\overload
*/
void TQDomElement::setAttributeNS( const TQString nsURI, const TQString& qName, ulong value )
{
if ( !impl )
return;
TQString x;
x.setNum( value );
IMPL->setAttributeNS( nsURI, qName, x );
}
/*!
\overload
*/
void TQDomElement::setAttributeNS( const TQString nsURI, const TQString& qName, double value )
{
if ( !impl )
return;
TQString x;
x.setNum( value );
IMPL->setAttributeNS( nsURI, qName, x );
}
/*!
Removes the attribute with the local name \a localName and the
namespace URI \a nsURI from this element.
\sa setAttributeNS() attributeNS() removeAttribute()
*/
void TQDomElement::removeAttributeNS( const TQString& nsURI, const TQString& localName )
{
if ( !impl )
return;
TQDomNodePrivate *n = IMPL->attributeNodeNS( nsURI, localName );
if ( !n )
return;
IMPL->removeAttribute( n->nodeName() );
}
/*!
Returns the TQDomAttr object that corresponds to the attribute with
the local name \a localName and the namespace URI \a nsURI. If no
such attribute exists a \link TQDomNode::isNull() null
attribute\endlink is returned.
\sa setAttributeNode() attribute() setAttribute() attributeNodeNS()
*/
TQDomAttr TQDomElement::attributeNodeNS( const TQString& nsURI, const TQString& localName )
{
if ( !impl )
return TQDomAttr();
return TQDomAttr( IMPL->attributeNodeNS( nsURI, localName ) );
}
/*!
Adds the attribute \a newAttr to this element.
If the element has another attribute that has the same local name
and namespace URI as \a newAttr, this function replaces that
attribute and returns it; otherwise the function returns a \link
TQDomNode::isNull() null attribute\endlink.
\sa attributeNodeNS() setAttributeNS() setAttributeNode()
*/
TQDomAttr TQDomElement::setAttributeNodeNS( const TQDomAttr& newAttr )
{
if ( !impl )
return TQDomAttr();
return TQDomAttr( IMPL->setAttributeNodeNS( ((TQDomAttrPrivate*)newAttr.impl) ) );
}
/*!
Returns a TQDomNodeList containing all the descendent elements of
this element with the local name \a localName and the namespace
URI \a nsURI. The order they are in the node list is the order
they are encountered in a preorder traversal of the element tree.
\sa elementsByTagName() TQDomDocument::elementsByTagNameNS()
*/
TQDomNodeList TQDomElement::elementsByTagNameNS( const TQString& nsURI, const TQString& localName ) const
{
return TQDomNodeList( new TQDomNodeListPrivate( impl, nsURI, localName ) );
}
/*!
Returns TRUE if this element has an attribute with the local name
\a localName and the namespace URI \a nsURI; otherwise returns
FALSE.
*/
bool TQDomElement::hasAttributeNS( const TQString& nsURI, const TQString& localName ) const
{
if ( !impl )
return FALSE;
return IMPL->hasAttributeNS( nsURI, localName );
}
/*!
Returns the element's text or TQString::null.
Example:
\code
<h1>Hello <b>TQt</b> <![CDATA[<xml is cool>]]></h1>
\endcode
The function text() of the TQDomElement for the <h1> tag,
will return "Hello TQt <xml is cool>".
Comments are ignored by this function. It only evaluates TQDomText
and TQDomCDATASection objects.
*/
TQString TQDomElement::text() const
{
if ( !impl )
return TQString::null;
return IMPL->text();
}
#undef IMPL
/**************************************************************
*
* TQDomTextPrivate
*
**************************************************************/
TQDomTextPrivate::TQDomTextPrivate( TQDomDocumentPrivate* d, TQDomNodePrivate* parent, const TQString& value )
: TQDomCharacterDataPrivate( d, parent, value )
{
name = "#text";
}
TQDomTextPrivate::TQDomTextPrivate( TQDomTextPrivate* n, bool deep )
: TQDomCharacterDataPrivate( n, deep )
{
}
TQDomTextPrivate::~TQDomTextPrivate()
{
}
TQDomNodePrivate* TQDomTextPrivate::cloneNode( bool deep)
{
TQDomNodePrivate* p = new TQDomTextPrivate( this, deep );
// We are not interested in this node
p->deref();
return p;
}
TQDomTextPrivate* TQDomTextPrivate::splitText( int offset )
{
if ( !parent() ) {
tqWarning( "TQDomText::splitText The node has no parent. So I can not split" );
return 0;
}
TQDomTextPrivate* t = new TQDomTextPrivate( ownerDocument(), 0, value.mid( offset ) );
value.truncate( offset );
parent()->insertAfter( t, this );
return t;
}
void TQDomTextPrivate::save( TQTextStream& s, int, int ) const
{
s << encodeAttr( value );
}
/**************************************************************
*
* TQDomText
*
**************************************************************/
#define IMPL ((TQDomTextPrivate*)impl)
/*!
\class TQDomText ntqdom.h
\reentrant
\brief The TQDomText class represents text data in the parsed XML document.
\if defined(commercial)
It is part of the <a href="commercialeditions.html">TQt Enterprise Edition</a>.
\endif
\module XML
\ingroup xml-tools
You can split the text in a TQDomText object over two TQDomText
objecs with splitText().
For further information about the Document Object Model see
\link http://www.w3.org/TR/REC-DOM-Level-1/\endlink and
\link http://www.w3.org/TR/DOM-Level-2-Core/\endlink.
For a more general introduction of the DOM implementation see the
TQDomDocument documentation.
*/
/*!
Constructs an empty TQDomText object.
To construct a TQDomText with content, use TQDomDocument::createTextNode().
*/
TQDomText::TQDomText()
: TQDomCharacterData()
{
}
/*!
Constructs a copy of \a x.
The data of the copy is shared (shallow copy): modifying one node
will also change the other. If you want to make a deep copy, use
cloneNode().
*/
TQDomText::TQDomText( const TQDomText& x )
: TQDomCharacterData( x )
{
}
TQDomText::TQDomText( TQDomTextPrivate* n )
: TQDomCharacterData( n )
{
}
/*!
Assigns \a x to this DOM text.
The data of the copy is shared (shallow copy): modifying one node
will also change the other. If you want to make a deep copy, use
cloneNode().
*/
TQDomText& TQDomText::operator= ( const TQDomText& x )
{
return (TQDomText&) TQDomNode::operator=( x );
}
/*!
Destroys the object and frees its resources.
*/
TQDomText::~TQDomText()
{
}
/*!
Returns \c TextNode.
*/
TQDomNode::NodeType TQDomText::nodeType() const
{
return TextNode;
}
/*!
Splits this DOM text object into two TQDomText objects. This object
keeps its first \a offset characters and the second (newly
created) object is inserted into the document tree after this
object with the remaining characters.
The function returns the newly created object.
\sa TQDomNode::normalize()
*/
TQDomText TQDomText::splitText( int offset )
{
if ( !impl )
return TQDomText();
return TQDomText( IMPL->splitText( offset ) );
}
/*!
Returns TRUE.
*/
bool TQDomText::isText() const
{
return TRUE;
}
#undef IMPL
/**************************************************************
*
* TQDomCommentPrivate
*
**************************************************************/
TQDomCommentPrivate::TQDomCommentPrivate( TQDomDocumentPrivate* d, TQDomNodePrivate* parent, const TQString& value )
: TQDomCharacterDataPrivate( d, parent, value )
{
name = "#comment";
}
TQDomCommentPrivate::TQDomCommentPrivate( TQDomCommentPrivate* n, bool deep )
: TQDomCharacterDataPrivate( n, deep )
{
}
TQDomCommentPrivate::~TQDomCommentPrivate()
{
}
TQDomNodePrivate* TQDomCommentPrivate::cloneNode( bool deep)
{
TQDomNodePrivate* p = new TQDomCommentPrivate( this, deep );
// We are not interested in this node
p->deref();
return p;
}
void TQDomCommentPrivate::save( TQTextStream& s, int, int ) const
{
s << "<!--" << value << "-->";
}
/**************************************************************
*
* TQDomComment
*
**************************************************************/
#define IMPL ((TQDomCommentPrivate*)impl)
/*!
\class TQDomComment ntqdom.h
\reentrant
\brief The TQDomComment class represents an XML comment.
\if defined(commercial)
It is part of the <a href="commercialeditions.html">TQt Enterprise Edition</a>.
\endif
\module XML
\ingroup xml-tools
A comment in the parsed XML such as this:
\code
<!-- this is a comment -->
\endcode
is represented by TQDomComment objects in the parsed Dom tree.
For further information about the Document Object Model see
\link http://www.w3.org/TR/REC-DOM-Level-1/\endlink and
\link http://www.w3.org/TR/DOM-Level-2-Core/\endlink.
For a more general introduction of the DOM implementation see the
TQDomDocument documentation.
*/
/*!
Constructs an empty comment. To construct a comment with content,
use the TQDomDocument::createComment() function.
*/
TQDomComment::TQDomComment()
: TQDomCharacterData()
{
}
/*!
Constructs a copy of \a x.
The data of the copy is shared (shallow copy): modifying one node
will also change the other. If you want to make a deep copy, use
cloneNode().
*/
TQDomComment::TQDomComment( const TQDomComment& x )
: TQDomCharacterData( x )
{
}
TQDomComment::TQDomComment( TQDomCommentPrivate* n )
: TQDomCharacterData( n )
{
}
/*!
Assigns \a x to this DOM comment.
The data of the copy is shared (shallow copy): modifying one node
will also change the other. If you want to make a deep copy, use
cloneNode().
*/
TQDomComment& TQDomComment::operator= ( const TQDomComment& x )
{
return (TQDomComment&) TQDomNode::operator=( x );
}
/*!
Destroys the object and frees its resources.
*/
TQDomComment::~TQDomComment()
{
}
/*!
Returns \c CommentNode.
*/
TQDomNode::NodeType TQDomComment::nodeType() const
{
return CommentNode;
}
/*!
Returns TRUE.
*/
bool TQDomComment::isComment() const
{
return TRUE;
}
#undef IMPL
/**************************************************************
*
* TQDomCDATASectionPrivate
*
**************************************************************/
TQDomCDATASectionPrivate::TQDomCDATASectionPrivate( TQDomDocumentPrivate* d, TQDomNodePrivate* parent,
const TQString& value )
: TQDomTextPrivate( d, parent, value )
{
name = "#cdata-section";
}
TQDomCDATASectionPrivate::TQDomCDATASectionPrivate( TQDomCDATASectionPrivate* n, bool deep )
: TQDomTextPrivate( n, deep )
{
}
TQDomCDATASectionPrivate::~TQDomCDATASectionPrivate()
{
}
TQDomNodePrivate* TQDomCDATASectionPrivate::cloneNode( bool deep)
{
TQDomNodePrivate* p = new TQDomCDATASectionPrivate( this, deep );
// We are not interested in this node
p->deref();
return p;
}
void TQDomCDATASectionPrivate::save( TQTextStream& s, int, int ) const
{
// ### How do we escape "]]>" ?
// "]]>" is not allowed; so there should be none in value anyway
s << "<![CDATA[" << value << "]]>";
}
/**************************************************************
*
* TQDomCDATASection
*
**************************************************************/
#define IMPL ((TQDomCDATASectionPrivate*)impl)
/*!
\class TQDomCDATASection ntqdom.h
\reentrant
\brief The TQDomCDATASection class represents an XML CDATA section.
\if defined(commercial)
It is part of the <a href="commercialeditions.html">TQt Enterprise Edition</a>.
\endif
\module XML
\ingroup xml-tools
CDATA sections are used to escape blocks of text containing
characters that would otherwise be regarded as markup. The only
delimiter that is recognized in a CDATA section is the "]]>"
string that terminates the CDATA section. CDATA sections cannot be
nested. Their primary purpose is for including material such as
XML fragments, without needing to escape all the delimiters.
Adjacent TQDomCDATASection nodes are not merged by the
TQDomNode::normalize() function.
For further information about the Document Object Model see
\link http://www.w3.org/TR/REC-DOM-Level-1/\endlink and
\link http://www.w3.org/TR/DOM-Level-2-Core/\endlink.
For a more general introduction of the DOM implementation see the
TQDomDocument documentation.
*/
/*!
Constructs an empty CDATA section. To create a CDATA section with
content, use the TQDomDocument::createCDATASection() function.
*/
TQDomCDATASection::TQDomCDATASection()
: TQDomText()
{
}
/*!
Constructs a copy of \a x.
The data of the copy is shared (shallow copy): modifying one node
will also change the other. If you want to make a deep copy, use
cloneNode().
*/
TQDomCDATASection::TQDomCDATASection( const TQDomCDATASection& x )
: TQDomText( x )
{
}
TQDomCDATASection::TQDomCDATASection( TQDomCDATASectionPrivate* n )
: TQDomText( n )
{
}
/*!
Assigns \a x to this CDATA section.
The data of the copy is shared (shallow copy): modifying one node
will also change the other. If you want to make a deep copy, use
cloneNode().
*/
TQDomCDATASection& TQDomCDATASection::operator= ( const TQDomCDATASection& x )
{
return (TQDomCDATASection&) TQDomNode::operator=( x );
}
/*!
Destroys the object and frees its resources.
*/
TQDomCDATASection::~TQDomCDATASection()
{
}
/*!
Returns \c CDATASection.
*/
TQDomNode::NodeType TQDomCDATASection::nodeType() const
{
return CDATASectionNode;
}
/*!
Returns TRUE.
*/
bool TQDomCDATASection::isCDATASection() const
{
return TRUE;
}
#undef IMPL
/**************************************************************
*
* TQDomNotationPrivate
*
**************************************************************/
TQDomNotationPrivate::TQDomNotationPrivate( TQDomDocumentPrivate* d, TQDomNodePrivate* parent,
const TQString& aname,
const TQString& pub, const TQString& sys )
: TQDomNodePrivate( d, parent )
{
name = aname;
m_pub = pub;
m_sys = sys;
}
TQDomNotationPrivate::TQDomNotationPrivate( TQDomNotationPrivate* n, bool deep )
: TQDomNodePrivate( n, deep )
{
m_sys = n->m_sys;
m_pub = n->m_pub;
}
TQDomNotationPrivate::~TQDomNotationPrivate()
{
}
TQDomNodePrivate* TQDomNotationPrivate::cloneNode( bool deep)
{
TQDomNodePrivate* p = new TQDomNotationPrivate( this, deep );
// We are not interested in this node
p->deref();
return p;
}
void TQDomNotationPrivate::save( TQTextStream& s, int, int ) const
{
s << "<!NOTATION " << name << " ";
if ( !m_pub.isNull() ) {
s << "PUBLIC \"" << m_pub << "\"";
if ( !m_sys.isNull() )
s << " \"" << m_sys << "\"";
} else {
s << "SYSTEM \"" << m_sys << "\"";
}
s << ">" << endl;
}
/**************************************************************
*
* TQDomNotation
*
**************************************************************/
#define IMPL ((TQDomNotationPrivate*)impl)
/*!
\class TQDomNotation ntqdom.h
\reentrant
\brief The TQDomNotation class represents an XML notation.
\if defined(commercial)
It is part of the <a href="commercialeditions.html">TQt Enterprise Edition</a>.
\endif
\module XML
\ingroup xml-tools
A notation either declares, by name, the format of an unparsed
entity (see section 4.7 of the XML 1.0 specification), or is used
for formal declaration of processing instruction targets (see
section 2.6 of the XML 1.0 specification).
DOM does not support editing notation nodes; they are therefore
read-only.
A notation node does not have any parent.
You can retrieve the publicId() and systemId() from a notation
node.
For further information about the Document Object Model see
\link http://www.w3.org/TR/REC-DOM-Level-1/\endlink and
\link http://www.w3.org/TR/DOM-Level-2-Core/\endlink.
For a more general introduction of the DOM implementation see the
TQDomDocument documentation.
*/
/*!
Constructor.
*/
TQDomNotation::TQDomNotation()
: TQDomNode()
{
}
/*!
Constructs a copy of \a x.
The data of the copy is shared (shallow copy): modifying one node
will also change the other. If you want to make a deep copy, use
cloneNode().
*/
TQDomNotation::TQDomNotation( const TQDomNotation& x )
: TQDomNode( x )
{
}
TQDomNotation::TQDomNotation( TQDomNotationPrivate* n )
: TQDomNode( n )
{
}
/*!
Assigns \a x to this DOM notation.
The data of the copy is shared (shallow copy): modifying one node
will also change the other. If you want to make a deep copy, use
cloneNode().
*/
TQDomNotation& TQDomNotation::operator= ( const TQDomNotation& x )
{
return (TQDomNotation&) TQDomNode::operator=( x );
}
/*!
Destroys the object and frees its resources.
*/
TQDomNotation::~TQDomNotation()
{
}
/*!
Returns \c NotationNode.
*/
TQDomNode::NodeType TQDomNotation::nodeType() const
{
return NotationNode;
}
/*!
Returns the public identifier of this notation.
*/
TQString TQDomNotation::publicId() const
{
if ( !impl )
return TQString::null;
return IMPL->m_pub;
}
/*!
Returns the system identifier of this notation.
*/
TQString TQDomNotation::systemId() const
{
if ( !impl )
return TQString::null;
return IMPL->m_sys;
}
/*!
Returns TRUE.
*/
bool TQDomNotation::isNotation() const
{
return TRUE;
}
#undef IMPL
/**************************************************************
*
* TQDomEntityPrivate
*
**************************************************************/
TQDomEntityPrivate::TQDomEntityPrivate( TQDomDocumentPrivate* d, TQDomNodePrivate* parent,
const TQString& aname,
const TQString& pub, const TQString& sys, const TQString& notation )
: TQDomNodePrivate( d, parent )
{
name = aname;
m_pub = pub;
m_sys = sys;
m_notationName = notation;
}
TQDomEntityPrivate::TQDomEntityPrivate( TQDomEntityPrivate* n, bool deep )
: TQDomNodePrivate( n, deep )
{
m_sys = n->m_sys;
m_pub = n->m_pub;
m_notationName = n->m_notationName;
}
TQDomEntityPrivate::~TQDomEntityPrivate()
{
}
TQDomNodePrivate* TQDomEntityPrivate::cloneNode( bool deep)
{
TQDomNodePrivate* p = new TQDomEntityPrivate( this, deep );
// We are not interested in this node
p->deref();
return p;
}
/*
Encode an entity value upon saving.
*/
static TQCString encodeEntity( const TQCString& str )
{
TQCString tmp( str );
uint len = tmp.length();
uint i = 0;
const char* d = tmp.data();
while ( i < len ) {
if ( d[i] == '%' ){
tmp.replace( i, 1, "<" );
d = tmp.data();
len += 4;
i += 5;
}
else if ( d[i] == '"' ) {
tmp.replace( i, 1, """ );
d = tmp.data();
len += 4;
i += 5;
} else if ( d[i] == '&' && i + 1 < len && d[i+1] == '#' ) {
// Dont encode < or " or &custom;.
// Only encode character references
tmp.replace( i, 1, "&" );
d = tmp.data();
len += 4;
i += 5;
} else {
++i;
}
}
return tmp;
}
void TQDomEntityPrivate::save( TQTextStream& s, int, int ) const
{
if ( m_sys.isNull() && m_pub.isNull() ) {
s << "<!ENTITY " << name << " \"" << encodeEntity( value.utf8() ) << "\">" << endl;
} else {
s << "<!ENTITY " << name << " ";
if ( m_pub.isNull() ) {
s << "SYSTEM \"" << m_sys << "\"";
} else {
s << "PUBLIC \"" << m_pub << "\" \"" << m_sys << "\"";
}
if (! m_notationName.isNull() ) {
s << " NDATA " << m_notationName;
}
s << ">" << endl;
}
}
/**************************************************************
*
* TQDomEntity
*
**************************************************************/
#define IMPL ((TQDomEntityPrivate*)impl)
/*!
\class TQDomEntity ntqdom.h
\reentrant
\brief The TQDomEntity class represents an XML entity.
\if defined(commercial)
It is part of the <a href="commercialeditions.html">TQt Enterprise Edition</a>.
\endif
\module XML
\ingroup xml-tools
This class represents an entity in an XML document, either parsed
or unparsed. Note that this models the entity itself not the
entity declaration.
DOM does not support editing entity nodes; if a user wants to make
changes to the contents of an entity, every related
TQDomEntityReference node must be replaced in the DOM tree by a
clone of the entity's contents, and then the desired changes must
be made to each of the clones instead. All the descendents of an
entity node are read-only.
An entity node does not have any parent.
You can access the entity's publicId(), systemId() and
notationName() when available.
For further information about the Document Object Model see
\link http://www.w3.org/TR/REC-DOM-Level-1/\endlink and
\link http://www.w3.org/TR/DOM-Level-2-Core/\endlink.
For a more general introduction of the DOM implementation see the
TQDomDocument documentation.
*/
/*!
Constructs an empty entity.
*/
TQDomEntity::TQDomEntity()
: TQDomNode()
{
}
/*!
Constructs a copy of \a x.
The data of the copy is shared (shallow copy): modifying one node
will also change the other. If you want to make a deep copy, use
cloneNode().
*/
TQDomEntity::TQDomEntity( const TQDomEntity& x )
: TQDomNode( x )
{
}
TQDomEntity::TQDomEntity( TQDomEntityPrivate* n )
: TQDomNode( n )
{
}
/*!
Assigns \a x to this DOM entity.
The data of the copy is shared (shallow copy): modifying one node
will also change the other. If you want to make a deep copy, use
cloneNode().
*/
TQDomEntity& TQDomEntity::operator= ( const TQDomEntity& x )
{
return (TQDomEntity&) TQDomNode::operator=( x );
}
/*!
Destroys the object and frees its resources.
*/
TQDomEntity::~TQDomEntity()
{
}
/*!
Returns \c EntityNode.
*/
TQDomNode::NodeType TQDomEntity::nodeType() const
{
return EntityNode;
}
/*!
Returns the public identifier associated with this entity. If the
public identifier was not specified TQString::null is returned.
*/
TQString TQDomEntity::publicId() const
{
if ( !impl )
return TQString::null;
return IMPL->m_pub;
}
/*!
Returns the system identifier associated with this entity. If the
system identifier was not specified TQString::null is returned.
*/
TQString TQDomEntity::systemId() const
{
if ( !impl )
return TQString::null;
return IMPL->m_sys;
}
/*!
For unparsed entities this function returns the name of the
notation for the entity. For parsed entities this function returns
TQString::null.
*/
TQString TQDomEntity::notationName() const
{
if ( !impl )
return TQString::null;
return IMPL->m_notationName;
}
/*!
Returns TRUE.
*/
bool TQDomEntity::isEntity() const
{
return TRUE;
}
#undef IMPL
/**************************************************************
*
* TQDomEntityReferencePrivate
*
**************************************************************/
TQDomEntityReferencePrivate::TQDomEntityReferencePrivate( TQDomDocumentPrivate* d, TQDomNodePrivate* parent, const TQString& aname )
: TQDomNodePrivate( d, parent )
{
name = aname;
}
TQDomEntityReferencePrivate::TQDomEntityReferencePrivate( TQDomNodePrivate* n, bool deep )
: TQDomNodePrivate( n, deep )
{
}
TQDomEntityReferencePrivate::~TQDomEntityReferencePrivate()
{
}
TQDomNodePrivate* TQDomEntityReferencePrivate::cloneNode( bool deep)
{
TQDomNodePrivate* p = new TQDomEntityReferencePrivate( this, deep );
// We are not interested in this node
p->deref();
return p;
}
void TQDomEntityReferencePrivate::save( TQTextStream& s, int, int ) const
{
s << "&" << name << ";";
}
/**************************************************************
*
* TQDomEntityReference
*
**************************************************************/
#define IMPL ((TQDomEntityReferencePrivate*)impl)
/*!
\class TQDomEntityReference ntqdom.h
\reentrant
\brief The TQDomEntityReference class represents an XML entity reference.
\if defined(commercial)
It is part of the <a href="commercialeditions.html">TQt Enterprise Edition</a>.
\endif
\module XML
\ingroup xml-tools
A TQDomEntityReference object may be inserted into the DOM tree
when an entity reference is in the source document, or when the
user wishes to insert an entity reference.
Note that character references and references to predefined
entities are expanded by the XML processor so that characters are
represented by their Unicode equivalent rather than by an entity
reference.
Moreover, the XML processor may completely expand references to
entities while building the DOM tree, instead of providing
TQDomEntityReference objects.
If it does provide such objects, then for a given entity reference
node, it may be that there is no entity node representing the
referenced entity; but if such an entity exists, then the child
list of the entity reference node is the same as that of the
entity node. As with the entity node, all descendents of the
entity reference are read-only.
For further information about the Document Object Model see
\link http://www.w3.org/TR/REC-DOM-Level-1/\endlink and
\link http://www.w3.org/TR/DOM-Level-2-Core/\endlink.
For a more general introduction of the DOM implementation see the
TQDomDocument documentation.
*/
/*!
Constructs an empty entity reference. Use
TQDomDocument::createEntityReference() to create a entity reference
with content.
*/
TQDomEntityReference::TQDomEntityReference()
: TQDomNode()
{
}
/*!
Constructs a copy of \a x.
The data of the copy is shared (shallow copy): modifying one node
will also change the other. If you want to make a deep copy, use
cloneNode().
*/
TQDomEntityReference::TQDomEntityReference( const TQDomEntityReference& x )
: TQDomNode( x )
{
}
TQDomEntityReference::TQDomEntityReference( TQDomEntityReferencePrivate* n )
: TQDomNode( n )
{
}
/*!
Assigns \a x to this entity reference.
The data of the copy is shared (shallow copy): modifying one node
will also change the other. If you want to make a deep copy, use
cloneNode().
*/
TQDomEntityReference& TQDomEntityReference::operator= ( const TQDomEntityReference& x )
{
return (TQDomEntityReference&) TQDomNode::operator=( x );
}
/*!
Destroys the object and frees its resources.
*/
TQDomEntityReference::~TQDomEntityReference()
{
}
/*!
Returns \c EntityReference.
*/
TQDomNode::NodeType TQDomEntityReference::nodeType() const
{
return EntityReferenceNode;
}
/*!
Returns TRUE.
*/
bool TQDomEntityReference::isEntityReference() const
{
return TRUE;
}
#undef IMPL
/**************************************************************
*
* TQDomProcessingInstructionPrivate
*
**************************************************************/
TQDomProcessingInstructionPrivate::TQDomProcessingInstructionPrivate( TQDomDocumentPrivate* d,
TQDomNodePrivate* parent, const TQString& target, const TQString& data )
: TQDomNodePrivate( d, parent )
{
name = target;
value = data;
}
TQDomProcessingInstructionPrivate::TQDomProcessingInstructionPrivate( TQDomProcessingInstructionPrivate* n, bool deep )
: TQDomNodePrivate( n, deep )
{
}
TQDomProcessingInstructionPrivate::~TQDomProcessingInstructionPrivate()
{
}
TQDomNodePrivate* TQDomProcessingInstructionPrivate::cloneNode( bool deep)
{
TQDomNodePrivate* p = new TQDomProcessingInstructionPrivate( this, deep );
// We are not interested in this node
p->deref();
return p;
}
void TQDomProcessingInstructionPrivate::save( TQTextStream& s, int, int ) const
{
s << "<?" << name << " " << value << "?>" << endl;
}
/**************************************************************
*
* TQDomProcessingInstruction
*
**************************************************************/
#define IMPL ((TQDomProcessingInstructionPrivate*)impl)
/*!
\class TQDomProcessingInstruction ntqdom.h
\reentrant
\brief The TQDomProcessingInstruction class represents an XML processing
instruction.
\if defined(commercial)
It is part of the <a href="commercialeditions.html">TQt Enterprise Edition</a>.
\endif
\module XML
\ingroup xml-tools
Processing instructions are used in XML to keep processor-specific
information in the text of the document.
The content of the processing instruction is retrieved with data()
and set with setData(). The processing instruction's target is
retrieved with target().
For further information about the Document Object Model see
\link http://www.w3.org/TR/REC-DOM-Level-1/\endlink and
\link http://www.w3.org/TR/DOM-Level-2-Core/\endlink.
For a more general introduction of the DOM implementation see the
TQDomDocument documentation.
*/
/*!
Constructs an empty processing instruction. Use
TQDomDocument::createProcessingInstruction() to create a processing
instruction with content.
*/
TQDomProcessingInstruction::TQDomProcessingInstruction()
: TQDomNode()
{
}
/*!
Constructs a copy of \a x.
The data of the copy is shared (shallow copy): modifying one node
will also change the other. If you want to make a deep copy, use
cloneNode().
*/
TQDomProcessingInstruction::TQDomProcessingInstruction( const TQDomProcessingInstruction& x )
: TQDomNode( x )
{
}
TQDomProcessingInstruction::TQDomProcessingInstruction( TQDomProcessingInstructionPrivate* n )
: TQDomNode( n )
{
}
/*!
Assigns \a x to this processing instruction.
The data of the copy is shared (shallow copy): modifying one node
will also change the other. If you want to make a deep copy, use
cloneNode().
*/
TQDomProcessingInstruction& TQDomProcessingInstruction::operator= ( const TQDomProcessingInstruction& x )
{
return (TQDomProcessingInstruction&) TQDomNode::operator=( x );
}
/*!
Destroys the object and frees its resources.
*/
TQDomProcessingInstruction::~TQDomProcessingInstruction()
{
}
/*!
Returns \c ProcessingInstructionNode.
*/
TQDomNode::NodeType TQDomProcessingInstruction::nodeType() const
{
return ProcessingInstructionNode;
}
/*!
Returns the target of this processing instruction.
\sa data()
*/
TQString TQDomProcessingInstruction::target() const
{
if ( !impl )
return TQString::null;
return impl->nodeName();
}
/*!
Returns the content of this processing instruction.
\sa setData() target()
*/
TQString TQDomProcessingInstruction::data() const
{
if ( !impl )
return TQString::null;
return impl->nodeValue();
}
/*!
Sets the data contained in the processing instruction to \a d.
\sa data()
*/
void TQDomProcessingInstruction::setData( const TQString& d )
{
if ( !impl )
return;
impl->setNodeValue( d );
}
/*!
Returns TRUE.
*/
bool TQDomProcessingInstruction::isProcessingInstruction() const
{
return TRUE;
}
#undef IMPL
/**************************************************************
*
* TQDomDocumentPrivate
*
**************************************************************/
TQDomDocumentPrivate::TQDomDocumentPrivate()
: TQDomNodePrivate( 0 )
{
impl = new TQDomImplementationPrivate();
type = new TQDomDocumentTypePrivate( this, this );
name = "#document";
}
TQDomDocumentPrivate::TQDomDocumentPrivate( const TQString& aname )
: TQDomNodePrivate( 0 )
{
impl = new TQDomImplementationPrivate();
type = new TQDomDocumentTypePrivate( this, this );
type->name = aname;
name = "#document";
}
TQDomDocumentPrivate::TQDomDocumentPrivate( TQDomDocumentTypePrivate* dt )
: TQDomNodePrivate( 0 )
{
impl = new TQDomImplementationPrivate();
if ( dt != 0 ) {
type = dt;
type->ref();
} else {
type = new TQDomDocumentTypePrivate( this, this );
}
name = "#document";
}
TQDomDocumentPrivate::TQDomDocumentPrivate( TQDomDocumentPrivate* n, bool deep )
: TQDomNodePrivate( n, deep )
{
impl = n->impl->clone();
// Reference count is down to 0, so we set it to 1 here.
impl->ref();
type = (TQDomDocumentTypePrivate*)n->type->cloneNode();
type->setParent( this );
// Reference count is down to 0, so we set it to 1 here.
type->ref();
}
TQDomDocumentPrivate::~TQDomDocumentPrivate()
{
if ( impl->deref() ) delete impl;
if ( type->deref() ) delete type;
}
void TQDomDocumentPrivate::clear()
{
if ( impl->deref() ) delete impl;
if ( type->deref() ) delete type;
impl = 0;
type = 0;
TQDomNodePrivate::clear();
}
bool TQDomDocumentPrivate::setContent( TQXmlInputSource *source, bool namespaceProcessing, TQString *errorMsg, int *errorLine, int *errorColumn )
{
TQXmlSimpleReader reader;
if ( namespaceProcessing ) {
reader.setFeature( "http://xml.org/sax/features/namespaces", TRUE );
reader.setFeature( "http://xml.org/sax/features/namespace-prefixes", FALSE );
} else {
reader.setFeature( "http://xml.org/sax/features/namespaces", FALSE );
reader.setFeature( "http://xml.org/sax/features/namespace-prefixes", TRUE );
}
reader.setFeature( "http://trolltech.com/xml/features/report-whitespace-only-CharData", FALSE );
reader.setUndefEntityInAttrHack( TRUE );
return setContent( source, &reader, errorMsg, errorLine, errorColumn );
}
bool TQDomDocumentPrivate::setContent( TQXmlInputSource *source, TQXmlReader *reader, TQString *errorMsg, int *errorLine, int *errorColumn )
{
clear();
impl = new TQDomImplementationPrivate;
type = new TQDomDocumentTypePrivate( this, this );
bool namespaceProcessing = reader->feature( "http://xml.org/sax/features/namespaces" )
&& !reader->feature( "http://xml.org/sax/features/namespace-prefixes" );
TQDomHandler hnd( this, namespaceProcessing );
reader->setContentHandler( &hnd );
reader->setErrorHandler( &hnd );
reader->setLexicalHandler( &hnd );
reader->setDeclHandler( &hnd );
reader->setDTDHandler( &hnd );
if ( !reader->parse( source ) ) {
if ( errorMsg )
*errorMsg = hnd.errorMsg;
if ( errorLine )
*errorLine = hnd.errorLine;
if ( errorColumn )
*errorColumn = hnd.errorColumn;
return FALSE;
}
return TRUE;
}
TQDomNodePrivate* TQDomDocumentPrivate::cloneNode( bool deep)
{
TQDomNodePrivate* p = new TQDomDocumentPrivate( this, deep );
// We are not interested in this node
p->deref();
return p;
}
TQDomElementPrivate* TQDomDocumentPrivate::documentElement()
{
TQDomNodePrivate* p = first;
while ( p && !p->isElement() )
p = p->next;
return (TQDomElementPrivate*)p;
}
TQDomElementPrivate* TQDomDocumentPrivate::createElement( const TQString& tagName )
{
TQDomElementPrivate* e = new TQDomElementPrivate( this, 0, tagName );
e->deref();
return e;
}
TQDomElementPrivate* TQDomDocumentPrivate::createElementNS( const TQString& nsURI, const TQString& qName )
{
TQDomElementPrivate* e = new TQDomElementPrivate( this, 0, nsURI, qName );
e->deref();
return e;
}
TQDomDocumentFragmentPrivate* TQDomDocumentPrivate::createDocumentFragment()
{
TQDomDocumentFragmentPrivate* f = new TQDomDocumentFragmentPrivate( this, (TQDomNodePrivate*)0 );
f->deref();
return f;
}
TQDomTextPrivate* TQDomDocumentPrivate::createTextNode( const TQString& data )
{
TQDomTextPrivate* t = new TQDomTextPrivate( this, 0, data );
t->deref();
return t;
}
TQDomCommentPrivate* TQDomDocumentPrivate::createComment( const TQString& data )
{
TQDomCommentPrivate* c = new TQDomCommentPrivate( this, 0, data );
c->deref();
return c;
}
TQDomCDATASectionPrivate* TQDomDocumentPrivate::createCDATASection( const TQString& data )
{
TQDomCDATASectionPrivate* c = new TQDomCDATASectionPrivate( this, 0, data );
c->deref();
return c;
}
TQDomProcessingInstructionPrivate* TQDomDocumentPrivate::createProcessingInstruction( const TQString& target, const TQString& data )
{
TQDomProcessingInstructionPrivate* p = new TQDomProcessingInstructionPrivate( this, 0, target, data );
p->deref();
return p;
}
TQDomAttrPrivate* TQDomDocumentPrivate::createAttribute( const TQString& aname )
{
TQDomAttrPrivate* a = new TQDomAttrPrivate( this, 0, aname );
a->deref();
return a;
}
TQDomAttrPrivate* TQDomDocumentPrivate::createAttributeNS( const TQString& nsURI, const TQString& qName )
{
TQDomAttrPrivate* a = new TQDomAttrPrivate( this, 0, nsURI, qName );
a->deref();
return a;
}
TQDomEntityReferencePrivate* TQDomDocumentPrivate::createEntityReference( const TQString& aname )
{
TQDomEntityReferencePrivate* e = new TQDomEntityReferencePrivate( this, 0, aname );
e->deref();
return e;
}
TQDomNodePrivate* TQDomDocumentPrivate::importNode( const TQDomNodePrivate* importedNode, bool deep )
{
TQDomNodePrivate *node = 0;
switch ( importedNode->nodeType() ) {
case TQDomNode::AttributeNode:
node = new TQDomAttrPrivate( (TQDomAttrPrivate*)importedNode, TRUE );
break;
case TQDomNode::DocumentFragmentNode:
node = new TQDomDocumentFragmentPrivate( (TQDomDocumentFragmentPrivate*)importedNode, deep );
break;
case TQDomNode::ElementNode:
node = new TQDomElementPrivate( (TQDomElementPrivate*)importedNode, deep );
break;
case TQDomNode::EntityNode:
node = new TQDomEntityPrivate( (TQDomEntityPrivate*)importedNode, deep );
break;
case TQDomNode::EntityReferenceNode:
node = new TQDomEntityReferencePrivate( (TQDomEntityReferencePrivate*)importedNode, FALSE );
break;
case TQDomNode::NotationNode:
node = new TQDomNotationPrivate( (TQDomNotationPrivate*)importedNode, deep );
break;
case TQDomNode::ProcessingInstructionNode:
node = new TQDomProcessingInstructionPrivate( (TQDomProcessingInstructionPrivate*)importedNode, deep );
break;
case TQDomNode::TextNode:
node = new TQDomTextPrivate( (TQDomTextPrivate*)importedNode, deep );
break;
case TQDomNode::CDATASectionNode:
node = new TQDomCDATASectionPrivate( (TQDomCDATASectionPrivate*)importedNode, deep );
break;
case TQDomNode::CommentNode:
node = new TQDomCommentPrivate( (TQDomCommentPrivate*)importedNode, deep );
break;
default:
break;
}
if ( node ) {
node->setOwnerDocument( this );
// The TQDomNode constructor increases the refcount, so deref() first to
// keep refcount balanced.
node->deref();
}
return node;
}
void TQDomDocumentPrivate::save( TQTextStream& s, int, int indent ) const
{
bool doc = FALSE;
TQDomNodePrivate* n = first;
if ( n && n->isProcessingInstruction() && n->nodeName()=="xml" ) {
// we have an XML declaration
TQString data = n->nodeValue();
TQRegExp encoding( TQString::fromLatin1("encoding\\s*=\\s*((\"([^\"]*)\")|('([^']*)'))") );
encoding.search( data );
TQString enc = encoding.cap(3);
if ( enc.isEmpty() ) {
enc = encoding.cap(5);
}
if ( enc.isEmpty() ) {
s.setEncoding( TQTextStream::UnicodeUTF8 );
} else {
s.setCodec( TQTextCodec::codecForName( enc ) );
}
} else {
s.setEncoding( TQTextStream::UnicodeUTF8 );
}
while ( n ) {
if ( !doc && !(n->isProcessingInstruction()&&n->nodeName()=="xml") ) {
// save doctype after XML declaration
type->save( s, 0, indent );
doc = TRUE;
}
n->save( s, 0, indent );
n = n->next;
}
}
/**************************************************************
*
* TQDomDocument
*
**************************************************************/
#define IMPL ((TQDomDocumentPrivate*)impl)
/*!
\class TQDomDocument ntqdom.h
\reentrant
\brief The TQDomDocument class represents an XML document.
\if defined(commercial)
It is part of the <a href="commercialeditions.html">TQt Enterprise Edition</a>.
\endif
\module XML
\ingroup xml-tools
The TQDomDocument class represents the entire XML document.
Conceptually, it is the root of the document tree, and provides
the primary access to the document's data.
Since elements, text nodes, comments, processing instructions,
etc., cannot exist outside the context of a document, the document
class also contains the factory functions needed to create these
objects. The node objects created have an ownerDocument() function
which associates them with the document within whose context they
were created. The DOM classes that will be used most often are
TQDomNode, TQDomDocument, TQDomElement and TQDomText.
The parsed XML is represented internally by a tree of objects that
can be accessed using the various TQDom classes. All TQDom classes
only \e reference objects in the internal tree. The internal
objects in the DOM tree will get deleted once the last TQDom
object referencing them and the TQDomDocument itself are deleted.
Creation of elements, text nodes, etc. is done using the various
factory functions provided in this class. Using the default
constructors of the TQDom classes will only result in empty
objects that cannot be manipulated or inserted into the Document.
The TQDomDocument class has several functions for creating document
data, for example, createElement(), createTextNode(),
createComment(), createCDATASection(),
createProcessingInstruction(), createAttribute() and
createEntityReference(). Some of these functions have versions
that support namespaces, i.e. createElementNS() and
createAttributeNS(). The createDocumentFragment() function is used
to hold parts of the document; this is useful for manipulating for
complex documents.
The entire content of the document is set with setContent(). This
function parses the string it is passed as an XML document and
creates the DOM tree that represents the document. The root
element is available using documentElement(). The textual
representation of the document can be obtained using toString().
It is possible to insert a node from another document into the
document using importNode().
You can obtain a list of all the elements that have a particular
tag with elementsByTagName() or with elementsByTagNameNS().
The TQDom classes are typically used as follows:
\code
TQDomDocument doc( "mydocument" );
TQFile file( "mydocument.xml" );
if ( !file.open( IO_ReadOnly ) )
return;
if ( !doc.setContent( &file ) ) {
file.close();
return;
}
file.close();
// print out the element names of all elements that are direct children
// of the outermost element.
TQDomElement docElem = doc.documentElement();
TQDomNode n = docElem.firstChild();
while( !n.isNull() ) {
TQDomElement e = n.toElement(); // try to convert the node to an element.
if( !e.isNull() ) {
cout << e.tagName() << endl; // the node really is an element.
}
n = n.nextSibling();
}
// Here we append a new element to the end of the document
TQDomElement elem = doc.createElement( "img" );
elem.setAttribute( "src", "myimage.png" );
docElem.appendChild( elem );
\endcode
Once \c doc and \c elem go out of scope, the whole internal tree
representing the XML document is deleted.
To create a document using DOM use code like this:
\code
TQDomDocument doc( "MyML" );
TQDomElement root = doc.createElement( "MyML" );
doc.appendChild( root );
TQDomElement tag = doc.createElement( "Greeting" );
root.appendChild( tag );
TQDomText t = doc.createTextNode( "Hello World" );
tag.appendChild( t );
TQString xml = doc.toString();
\endcode
For further information about the Document Object Model see
\link http://www.w3.org/TR/REC-DOM-Level-1/\endlink and
\link http://www.w3.org/TR/DOM-Level-2-Core/\endlink.
For a more general introduction of the DOM implementation see the
TQDomDocument documentation.
*/
/*!
Constructs an empty document.
*/
TQDomDocument::TQDomDocument()
{
impl = 0;
}
/*!
Creates a document and sets the name of the document type to \a
name.
*/
TQDomDocument::TQDomDocument( const TQString& name )
{
// We take over ownership
impl = new TQDomDocumentPrivate( name );
}
/*!
Creates a document with the document type \a doctype.
\sa TQDomImplementation::createDocumentType()
*/
TQDomDocument::TQDomDocument( const TQDomDocumentType& doctype )
{
impl = new TQDomDocumentPrivate( (TQDomDocumentTypePrivate*)(doctype.impl) );
}
/*!
Constructs a copy of \a x.
The data of the copy is shared (shallow copy): modifying one node
will also change the other. If you want to make a deep copy, use
cloneNode().
*/
TQDomDocument::TQDomDocument( const TQDomDocument& x )
: TQDomNode( x )
{
}
TQDomDocument::TQDomDocument( TQDomDocumentPrivate* x )
: TQDomNode( x )
{
}
/*!
Assigns \a x to this DOM document.
The data of the copy is shared (shallow copy): modifying one node
will also change the other. If you want to make a deep copy, use
cloneNode().
*/
TQDomDocument& TQDomDocument::operator= ( const TQDomDocument& x )
{
return (TQDomDocument&) TQDomNode::operator=( x );
}
/*!
Destroys the object and frees its resources.
*/
TQDomDocument::~TQDomDocument()
{
}
/*!
\overload
This function reads the XML document from the string \a text.
Since \a text is already a Unicode string, no encoding detection
is done.
*/
bool TQDomDocument::setContent( const TQString& text, bool namespaceProcessing, TQString *errorMsg, int *errorLine, int *errorColumn )
{
if ( !impl )
impl = new TQDomDocumentPrivate;
TQXmlInputSource source;
source.setData( text );
return IMPL->setContent( &source, namespaceProcessing, errorMsg, errorLine, errorColumn );
}
/*!
This function parses the XML document from the byte array \a
buffer and sets it as the content of the document. It tries to
detect the encoding of the document as required by the XML
specification.
If \a namespaceProcessing is TRUE, the parser recognizes
namespaces in the XML file and sets the prefix name, local name
and namespace URI to appropriate values. If \a namespaceProcessing
is FALSE, the parser does no namespace processing when it reads
the XML file.
If a parse error occurs, the function returns FALSE; otherwise it
returns TRUE. If a parse error occurs and \a errorMsg, \a
errorLine and \a errorColumn are not 0, the error message is
placed in \a *errorMsg, the line number \a *errorLine and the
column number in \a *errorColumn.
If \a namespaceProcessing is TRUE, the function TQDomNode::prefix()
returns a string for all elements and attributes. It returns an
empty string if the element or attribute has no prefix.
If \a namespaceProcessing is FALSE, the functions
TQDomNode::prefix(), TQDomNode::localName() and
TQDomNode::namespaceURI() return TQString::null.
\sa TQDomNode::namespaceURI() TQDomNode::localName()
TQDomNode::prefix() TQString::isNull() TQString::isEmpty()
*/
bool TQDomDocument::setContent( const TQByteArray& buffer, bool namespaceProcessing, TQString *errorMsg, int *errorLine, int *errorColumn )
{
if ( !impl )
impl = new TQDomDocumentPrivate;
TQBuffer buf( buffer );
TQXmlInputSource source( &buf );
return IMPL->setContent( &source, namespaceProcessing, errorMsg, errorLine, errorColumn );
}
/*!
\overload
This function reads the XML document from the C string \a buffer.
\warning This function does not try to detect the encoding:
instead it assumes that the C string is UTF-8 encoded.
*/
bool TQDomDocument::setContent( const TQCString& buffer, bool namespaceProcessing, TQString *errorMsg, int *errorLine, int *errorColumn )
{
return setContent( TQString::fromUtf8( buffer, buffer.length() ), namespaceProcessing, errorMsg, errorLine, errorColumn );
}
/*!
\overload
This function reads the XML document from the IO device \a dev.
*/
bool TQDomDocument::setContent( TQIODevice* dev, bool namespaceProcessing, TQString *errorMsg, int *errorLine, int *errorColumn )
{
if ( !impl )
impl = new TQDomDocumentPrivate;
TQXmlInputSource source( dev );
return IMPL->setContent( &source, namespaceProcessing, errorMsg, errorLine, errorColumn );
}
/*!
\overload
This function reads the XML document from the string \a text.
Since \a text is already a Unicode string, no encoding detection
is performed.
No namespace processing is performed either.
*/
bool TQDomDocument::setContent( const TQString& text, TQString *errorMsg, int *errorLine, int *errorColumn )
{
return setContent( text, FALSE, errorMsg, errorLine, errorColumn );
}
/*!
\overload
This function reads the XML document from the byte array \a
buffer.
No namespace processing is performed.
*/
bool TQDomDocument::setContent( const TQByteArray& buffer, TQString *errorMsg, int *errorLine, int *errorColumn )
{
return setContent( buffer, FALSE, errorMsg, errorLine, errorColumn );
}
/*!
\overload
This function reads the XML document from the C string \a buffer.
No namespace processing is performed.
\warning This function does not try to detect the encoding:
instead it assumes that the C string is UTF-8 encoded.
*/
bool TQDomDocument::setContent( const TQCString& buffer, TQString *errorMsg, int *errorLine, int *errorColumn )
{
return setContent( buffer, FALSE, errorMsg, errorLine, errorColumn );
}
/*!
\overload
This function reads the XML document from the IO device \a dev.
No namespace processing is performed.
*/
bool TQDomDocument::setContent( TQIODevice* dev, TQString *errorMsg, int *errorLine, int *errorColumn )
{
return setContent( dev, FALSE, errorMsg, errorLine, errorColumn );
}
/*!
\overload
This function reads the XML document from the TQXmlInputSource \a source and
parses it with the TQXmlReader \a reader.
This function doesn't change the features of the \a reader. If you want to
use certain features for parsing you can use this function to set up the
reader appropriate.
\sa TQXmlSimpleReader
*/
bool TQDomDocument::setContent( TQXmlInputSource *source, TQXmlReader *reader, TQString *errorMsg, int *errorLine, int *errorColumn )
{
if ( !impl )
impl = new TQDomDocumentPrivate;
return IMPL->setContent( source, reader, errorMsg, errorLine, errorColumn );
}
/*!
Converts the parsed document back to its textual representation.
\sa toCString()
*/
TQString TQDomDocument::toString() const
{
TQString str;
TQTextStream s( str, IO_WriteOnly );
save( s, 1 );
return str;
}
/*!
\overload
This function uses \a indent as the amount of space to indent
subelements.
*/
TQString TQDomDocument::toString( int indent ) const
{
TQString str;
TQTextStream s( str, IO_WriteOnly );
save( s, indent );
return str;
}
/*!
Converts the parsed document back to its textual representation
and returns a TQCString for that is encoded in UTF-8.
\sa toString()
*/
TQCString TQDomDocument::toCString() const
{
// ### if there is an encoding specified in the xml declaration, this
// encoding declaration should be changed to utf8
return toString().utf8();
}
/*!
\overload
This function uses \a indent as the amount of space to indent
subelements.
*/
TQCString TQDomDocument::toCString( int indent ) const
{
// ### if there is an encoding specified in the xml declaration, this
// encoding declaration should be changed to utf8
return toString( indent ).utf8();
}
/*!
Returns the document type of this document.
*/
TQDomDocumentType TQDomDocument::doctype() const
{
if ( !impl )
return TQDomDocumentType();
return TQDomDocumentType( IMPL->doctype() );
}
/*!
Returns a TQDomImplementation object.
*/
TQDomImplementation TQDomDocument::implementation() const
{
if ( !impl )
return TQDomImplementation();
return TQDomImplementation( IMPL->implementation() );
}
/*!
Returns the root element of the document.
*/
TQDomElement TQDomDocument::documentElement() const
{
if ( !impl )
return TQDomElement();
return TQDomElement( IMPL->documentElement() );
}
/*!
Creates a new element called \a tagName that can be inserted into
the DOM tree, e.g. using TQDomNode::appendChild().
\sa createElementNS() TQDomNode::appendChild() TQDomNode::insertBefore()
TQDomNode::insertAfter()
*/
TQDomElement TQDomDocument::createElement( const TQString& tagName )
{
if ( !impl )
impl = new TQDomDocumentPrivate;
return TQDomElement( IMPL->createElement( tagName ) );
}
/*!
Creates a new document fragment, that can be used to hold parts of
the document, e.g. when doing complex manipulations of the
document tree.
*/
TQDomDocumentFragment TQDomDocument::createDocumentFragment()
{
if ( !impl )
impl = new TQDomDocumentPrivate;
return TQDomDocumentFragment( IMPL->createDocumentFragment() );
}
/*!
Creates a text node for the string \a value that can be inserted
into the document tree, e.g. using TQDomNode::appendChild().
\warning All characters within an XML document must be in the range:
#x9 | #xA | #xD | [#x20-#xD7FF] | [#xE000-#xFFFD] | [#x10000-#x10FFFF]
This rule also applies to characters encoded as character entities and
characters in CDATA sections. If you use this function to insert
characters outside of this range, the document will not be well-formed.
If you want to store binary data in an XML document you must either use
your own scheme to escape illegal characters, or you must store it in
an external unparsed entity.
\sa TQDomNode::appendChild() TQDomNode::insertBefore() TQDomNode::insertAfter()
*/
TQDomText TQDomDocument::createTextNode( const TQString& value )
{
if ( !impl )
impl = new TQDomDocumentPrivate;
return TQDomText( IMPL->createTextNode( value ) );
}
/*!
Creates a new comment for the string \a value that can be inserted
into the document, e.g. using TQDomNode::appendChild().
\sa TQDomNode::appendChild() TQDomNode::insertBefore() TQDomNode::insertAfter()
*/
TQDomComment TQDomDocument::createComment( const TQString& value )
{
if ( !impl )
impl = new TQDomDocumentPrivate;
return TQDomComment( IMPL->createComment( value ) );
}
/*!
Creates a new CDATA section for the string \a value that can be
inserted into the document, e.g. using TQDomNode::appendChild().
\sa TQDomNode::appendChild() TQDomNode::insertBefore() TQDomNode::insertAfter()
*/
TQDomCDATASection TQDomDocument::createCDATASection( const TQString& value )
{
if ( !impl )
impl = new TQDomDocumentPrivate;
return TQDomCDATASection( IMPL->createCDATASection( value ) );
}
/*!
Creates a new processing instruction that can be inserted into the
document, e.g. using TQDomNode::appendChild(). This function sets
the target for the processing instruction to \a target and the
data to \a data.
\sa TQDomNode::appendChild() TQDomNode::insertBefore() TQDomNode::insertAfter()
*/
TQDomProcessingInstruction TQDomDocument::createProcessingInstruction( const TQString& target,
const TQString& data )
{
if ( !impl )
impl = new TQDomDocumentPrivate;
return TQDomProcessingInstruction( IMPL->createProcessingInstruction( target, data ) );
}
/*!
Creates a new attribute called \a name that can be inserted into
an element, e.g. using TQDomElement::setAttributeNode().
\sa createAttributeNS()
*/
TQDomAttr TQDomDocument::createAttribute( const TQString& name )
{
if ( !impl )
impl = new TQDomDocumentPrivate;
return TQDomAttr( IMPL->createAttribute( name ) );
}
/*!
Creates a new entity reference called \a name that can be inserted
into the document, e.g. using TQDomNode::appendChild().
\sa TQDomNode::appendChild() TQDomNode::insertBefore() TQDomNode::insertAfter()
*/
TQDomEntityReference TQDomDocument::createEntityReference( const TQString& name )
{
if ( !impl )
impl = new TQDomDocumentPrivate;
return TQDomEntityReference( IMPL->createEntityReference( name ) );
}
/*!
Returns a TQDomNodeList, that contains all the elements in the
document with the name \a tagname. The order of the node list is
the order they are encountered in a preorder traversal of the
element tree.
\sa elementsByTagNameNS() TQDomElement::elementsByTagName()
*/
TQDomNodeList TQDomDocument::elementsByTagName( const TQString& tagname ) const
{
return TQDomNodeList( new TQDomNodeListPrivate( impl, tagname ) );
}
/*!
Imports the node \a importedNode from another document to this
document. \a importedNode remains in the original document; this
function creates a copy that can be used within this document.
This function returns the imported node that belongs to this
document. The returned node has no parent. It is not possible to
import TQDomDocument and TQDomDocumentType nodes. In those cases
this function returns a \link TQDomNode::isNull() null node\endlink.
If \a deep is TRUE, this function imports not only the node \a
importedNode but its whole subtree; if it is FALSE, only the \a
importedNode is imported. The argument \a deep has no effect on
TQDomAttr and TQDomEntityReference nodes, since the descendents of
TQDomAttr nodes are always imported and those of
TQDomEntityReference nodes are never imported.
The behavior of this function is slightly different depending on
the node types:
\table
\header \i Node Type \i Behaviour
\row \i TQDomAttr
\i The owner element is set to 0 and the specified flag is
set to TRUE in the generated attribute. The whole subtree
of \a importedNode is always imported for attribute nodes:
\a deep has no effect.
\row \i TQDomDocument
\i Document nodes cannot be imported.
\row \i TQDomDocumentFragment
\i If \a deep is TRUE, this function imports the whole
document fragment; otherwise it only generates an empty
document fragment.
\row \i TQDomDocumentType
\i Document type nodes cannot be imported.
\row \i TQDomElement
\i Attributes for which TQDomAttr::specified() is TRUE are
also imported, other attributes are not imported. If \a
deep is TRUE, this function also imports the subtree of \a
importedNode; otherwise it imports only the element node
(and some attributes, see above).
\row \i TQDomEntity
\i Entity nodes can be imported, but at the moment there is
no way to use them since the document type is read-only in
DOM level 2.
\row \i TQDomEntityReference
\i Descendents of entity reference nodes are never imported:
\a deep has no effect.
\row \i TQDomNotation
\i Notation nodes can be imported, but at the moment there is
no way to use them since the document type is read-only in
DOM level 2.
\row \i TQDomProcessingInstruction
\i The target and value of the processing instruction is
copied to the new node.
\row \i TQDomText
\i The text is copied to the new node.
\row \i TQDomCDATASection
\i The text is copied to the new node.
\row \i TQDomComment
\i The text is copied to the new node.
\endtable
\sa TQDomElement::setAttribute() TQDomNode::insertBefore()
TQDomNode::insertAfter() TQDomNode::replaceChild() TQDomNode::removeChild()
TQDomNode::appendChild()
*/
TQDomNode TQDomDocument::importNode( const TQDomNode& importedNode, bool deep )
{
if ( !impl )
impl = new TQDomDocumentPrivate;
return TQDomNode( IMPL->importNode( importedNode.impl, deep ) );
}
/*!
Creates a new element with namespace support that can be inserted
into the DOM tree. The name of the element is \a qName and the
namespace URI is \a nsURI. This function also sets
TQDomNode::prefix() and TQDomNode::localName() to appropriate values
(depending on \a qName).
\sa createElement()
*/
TQDomElement TQDomDocument::createElementNS( const TQString& nsURI, const TQString& qName )
{
if ( !impl )
impl = new TQDomDocumentPrivate;
return TQDomElement( IMPL->createElementNS( nsURI, qName ) );
}
/*!
Creates a new attribute with namespace support that can be
inserted into an element. The name of the attribute is \a qName
and the namespace URI is \a nsURI. This function also sets
TQDomNode::prefix() and TQDomNode::localName() to appropriate values
(depending on \a qName).
\sa createAttribute()
*/
TQDomAttr TQDomDocument::createAttributeNS( const TQString& nsURI, const TQString& qName )
{
if ( !impl )
impl = new TQDomDocumentPrivate;
return TQDomAttr( IMPL->createAttributeNS( nsURI, qName ) );
}
/*!
Returns a TQDomNodeList that contains all the elements in the
document with the local name \a localName and a namespace URI of
\a nsURI. The order of the node list is the order they are
encountered in a preorder traversal of the element tree.
\sa elementsByTagName() TQDomElement::elementsByTagNameNS()
*/
TQDomNodeList TQDomDocument::elementsByTagNameNS( const TQString& nsURI, const TQString& localName )
{
return TQDomNodeList( new TQDomNodeListPrivate( impl, nsURI, localName ) );
}
/*!
Returns the element whose ID is equal to \a elementId. If no
element with the ID was found, this function returns a \link
TQDomNode::isNull() null element\endlink.
Since the TQDomClasses do not know which attributes are element
IDs, this function returns always a \link TQDomNode::isNull() null
element\endlink. This may change in a future version.
*/
TQDomElement TQDomDocument::elementById( const TQString& /*elementId*/ )
{
return TQDomElement();
}
/*!
Returns \c DocumentNode.
*/
TQDomNode::NodeType TQDomDocument::nodeType() const
{
return DocumentNode;
}
/*!
Returns TRUE.
*/
bool TQDomDocument::isDocument() const
{
return TRUE;
}
#undef IMPL
/**************************************************************
*
* Node casting functions
*
**************************************************************/
/*!
Converts a TQDomNode into a TQDomAttr. If the node is not an
attribute, the returned object will be \link TQDomNode::isNull()
null\endlink.
\sa isAttr()
*/
TQDomAttr TQDomNode::toAttr()
{
if ( impl && impl->isAttr() )
return TQDomAttr( ((TQDomAttrPrivate*)impl) );
return TQDomAttr();
}
/*!
Converts a TQDomNode into a TQDomCDATASection. If the node is not a
CDATA section, the returned object will be \link
TQDomNode::isNull() null\endlink.
\sa isCDATASection()
*/
TQDomCDATASection TQDomNode::toCDATASection()
{
if ( impl && impl->isCDATASection() )
return TQDomCDATASection( ((TQDomCDATASectionPrivate*)impl) );
return TQDomCDATASection();
}
/*!
Converts a TQDomNode into a TQDomDocumentFragment. If the node is
not a document fragment the returned object will be \link
TQDomNode::isNull() null\endlink.
\sa isDocumentFragment()
*/
TQDomDocumentFragment TQDomNode::toDocumentFragment()
{
if ( impl && impl->isDocumentFragment() )
return TQDomDocumentFragment( ((TQDomDocumentFragmentPrivate*)impl) );
return TQDomDocumentFragment();
}
/*!
Converts a TQDomNode into a TQDomDocument. If the node is not a
document the returned object will be \link TQDomNode::isNull()
null\endlink.
\sa isDocument()
*/
TQDomDocument TQDomNode::toDocument()
{
if ( impl && impl->isDocument() )
return TQDomDocument( ((TQDomDocumentPrivate*)impl) );
return TQDomDocument();
}
/*!
Converts a TQDomNode into a TQDomDocumentType. If the node is not a
document type the returned object will be \link TQDomNode::isNull()
null\endlink.
\sa isDocumentType()
*/
TQDomDocumentType TQDomNode::toDocumentType()
{
if ( impl && impl->isDocumentType() )
return TQDomDocumentType( ((TQDomDocumentTypePrivate*)impl) );
return TQDomDocumentType();
}
/*!
Converts a TQDomNode into a TQDomElement. If the node is not an
element the returned object will be \link TQDomNode::isNull()
null\endlink.
\sa isElement()
*/
TQDomElement TQDomNode::toElement()
{
if ( impl && impl->isElement() )
return TQDomElement( ((TQDomElementPrivate*)impl) );
return TQDomElement();
}
/*!
Converts a TQDomNode into a TQDomEntityReference. If the node is not
an entity reference, the returned object will be \link
TQDomNode::isNull() null\endlink.
\sa isEntityReference()
*/
TQDomEntityReference TQDomNode::toEntityReference()
{
if ( impl && impl->isEntityReference() )
return TQDomEntityReference( ((TQDomEntityReferencePrivate*)impl) );
return TQDomEntityReference();
}
/*!
Converts a TQDomNode into a TQDomText. If the node is not a text,
the returned object will be \link TQDomNode::isNull() null\endlink.
\sa isText()
*/
TQDomText TQDomNode::toText()
{
if ( impl && impl->isText() )
return TQDomText( ((TQDomTextPrivate*)impl) );
return TQDomText();
}
/*!
Converts a TQDomNode into a TQDomEntity. If the node is not an
entity the returned object will be \link TQDomNode::isNull()
null\endlink.
\sa isEntity()
*/
TQDomEntity TQDomNode::toEntity()
{
if ( impl && impl->isEntity() )
return TQDomEntity( ((TQDomEntityPrivate*)impl) );
return TQDomEntity();
}
/*!
Converts a TQDomNode into a TQDomNotation. If the node is not a
notation the returned object will be \link TQDomNode::isNull()
null\endlink.
\sa isNotation()
*/
TQDomNotation TQDomNode::toNotation()
{
if ( impl && impl->isNotation() )
return TQDomNotation( ((TQDomNotationPrivate*)impl) );
return TQDomNotation();
}
/*!
Converts a TQDomNode into a TQDomProcessingInstruction. If the node
is not a processing instruction the returned object will be \link
TQDomNode::isNull() null\endlink.
\sa isProcessingInstruction()
*/
TQDomProcessingInstruction TQDomNode::toProcessingInstruction()
{
if ( impl && impl->isProcessingInstruction() )
return TQDomProcessingInstruction( ((TQDomProcessingInstructionPrivate*)impl) );
return TQDomProcessingInstruction();
}
/*!
Converts a TQDomNode into a TQDomCharacterData. If the node is not a
character data node the returned object will be \link
TQDomNode::isNull() null\endlink.
\sa isCharacterData()
*/
TQDomCharacterData TQDomNode::toCharacterData()
{
if ( impl && impl->isCharacterData() )
return TQDomCharacterData( ((TQDomCharacterDataPrivate*)impl) );
return TQDomCharacterData();
}
/*!
Converts a TQDomNode into a TQDomComment. If the node is not a
comment the returned object will be \link TQDomNode::isNull()
null\endlink.
\sa isComment()
*/
TQDomComment TQDomNode::toComment()
{
if ( impl && impl->isComment() )
return TQDomComment( ((TQDomCommentPrivate*)impl) );
return TQDomComment();
}
/**************************************************************
*
* TQDomHandler
*
**************************************************************/
TQDomHandler::TQDomHandler( TQDomDocumentPrivate* adoc, bool namespaceProcessing )
{
doc = adoc;
node = doc;
cdata = FALSE;
nsProcessing = namespaceProcessing;
}
TQDomHandler::~TQDomHandler()
{
}
bool TQDomHandler::endDocument()
{
// ### is this really necessary? (rms)
if ( node != doc )
return FALSE;
return TRUE;
}
bool TQDomHandler::startDTD( const TQString& name, const TQString& publicId, const TQString& systemId )
{
doc->doctype()->name = name;
doc->doctype()->publicId = publicId;
doc->doctype()->systemId = systemId;
return TRUE;
}
bool TQDomHandler::startElement( const TQString& nsURI, const TQString&, const TQString& qName, const TQXmlAttributes& atts )
{
// tag name
TQDomNodePrivate* n;
if ( nsProcessing ) {
n = doc->createElementNS( nsURI, qName );
} else {
n = doc->createElement( qName );
}
node->appendChild( n );
node = n;
// attributes
for ( int i=0; i<atts.length(); i++ )
{
if ( nsProcessing ) {
((TQDomElementPrivate*)node)->setAttributeNS( atts.uri(i), atts.qName(i), atts.value(i) );
} else {
((TQDomElementPrivate*)node)->setAttribute( atts.qName(i), atts.value(i) );
}
}
return TRUE;
}
bool TQDomHandler::endElement( const TQString&, const TQString&, const TQString& )
{
if ( node == doc )
return FALSE;
node = node->parent();
return TRUE;
}
bool TQDomHandler::characters( const TQString& ch )
{
// No text as child of some document
if ( node == doc )
return FALSE;
if ( cdata ) {
node->appendChild( doc->createCDATASection( ch ) );
} else if ( !entityName.isEmpty() ) {
TQDomEntityPrivate* e = new TQDomEntityPrivate( doc, 0, entityName,
TQString::null, TQString::null, TQString::null );
e->value = ch;
doc->doctype()->appendChild( e );
node->appendChild( doc->createEntityReference( entityName ) );
} else {
node->appendChild( doc->createTextNode( ch ) );
}
return TRUE;
}
bool TQDomHandler::processingInstruction( const TQString& target, const TQString& data )
{
node->appendChild( doc->createProcessingInstruction( target, data ) );
return TRUE;
}
bool TQDomHandler::skippedEntity( const TQString& name )
{
node->appendChild( doc->createEntityReference( name ) );
return TRUE;
}
bool TQDomHandler::fatalError( const TQXmlParseException& exception )
{
errorMsg = exception.message();
errorLine = exception.lineNumber();
errorColumn = exception.columnNumber();
return TQXmlDefaultHandler::fatalError( exception );
}
bool TQDomHandler::startCDATA()
{
cdata = TRUE;
return TRUE;
}
bool TQDomHandler::endCDATA()
{
cdata = FALSE;
return TRUE;
}
bool TQDomHandler::startEntity( const TQString &name )
{
entityName = name;
return TRUE;
}
bool TQDomHandler::endEntity( const TQString & )
{
entityName = TQString::null;
return TRUE;
}
bool TQDomHandler::comment( const TQString& ch )
{
node->appendChild( doc->createComment( ch ) );
return TRUE;
}
bool TQDomHandler::unparsedEntityDecl( const TQString &name, const TQString &publicId, const TQString &systemId, const TQString ¬ationName )
{
TQDomEntityPrivate* e = new TQDomEntityPrivate( doc, 0, name,
publicId, systemId, notationName );
doc->doctype()->appendChild( e );
return TRUE;
}
bool TQDomHandler::externalEntityDecl( const TQString &name, const TQString &publicId, const TQString &systemId )
{
return unparsedEntityDecl( name, publicId, systemId, TQString::null );
}
bool TQDomHandler::notationDecl( const TQString & name, const TQString & publicId, const TQString & systemId )
{
TQDomNotationPrivate* n = new TQDomNotationPrivate( doc, 0, name, publicId, systemId );
doc->doctype()->appendChild( n );
return TRUE;
}
#endif //QT_NO_DOM