QDomDocumentFragment

Section: Misc. Reference Manual Pages (3qt)
Updated: 2 February 2007
Index Return to Main Contents
 

NAME

QDomDocumentFragment - Tree of QDomNodes which is not usually a complete QDomDocument  

SYNOPSIS

All the functions in this class are reentrant when Qt is built with thread support.</p>

#include <qdom.h>

Inherits QDomNode.

 

Public Members


QDomDocumentFragment ()

QDomDocumentFragment ( const QDomDocumentFragment & x )

QDomDocumentFragment & operator= ( const QDomDocumentFragment & x )

~QDomDocumentFragment ()

virtual QDomNode::NodeType nodeType () const

virtual bool isDocumentFragment () const
 

DESCRIPTION

The QDomDocumentFragment class is a tree of QDomNodes which is not usually a complete QDomDocument.

If you want to do complex tree operations it is useful to have a lightweight class to store nodes and their relations. QDomDocumentFragment stores a subtree of a document which does not necessarily represent a well-formed XML document.

QDomDocumentFragment 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 QDomDocumentFragment can be used as a temporary container for this list of children.

The most important feature of QDomDocumentFragment is that it is treated in a special way by QDomNode::insertAfter(), QDomNode::insertBefore(), QDomNode::replaceChild() and QDomNode::appendChild(): instead of inserting the fragment itself, all the fragment's children are inserted.

See also XML.  

MEMBER FUNCTION DOCUMENTATION

 

QDomDocumentFragment::QDomDocumentFragment ()

Constructs an empty document fragment.  

QDomDocumentFragment::QDomDocumentFragment ( const QDomDocumentFragment & x )

Constructs a copy of 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().  

QDomDocumentFragment::~QDomDocumentFragment ()

Destroys the object and frees its resources.  

bool QDomDocumentFragment::isDocumentFragment () const [virtual]

This function reimplements QDomNode::isDocumentFragment().

See also nodeType() and QDomNode::toDocumentFragment().

Reimplemented from QDomNode.  

QDomNode::NodeType QDomDocumentFragment::nodeType () const [virtual]

Returns DocumentFragment.

See also isDocumentFragment() and QDomNode::toDocumentFragment().

Reimplemented from QDomNode.  

QDomDocumentFragment & QDomDocumentFragment::operator= ( const QDomDocumentFragment & x )

Assigns 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().

 

SEE ALSO

http://doc.trolltech.com/qdomdocumentfragment.html http://www.trolltech.com/faq/tech.html  

COPYRIGHT

Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the license file included in the distribution for a complete license statement.  

AUTHOR

Generated automatically from the source code.  

BUGS

If you find a bug in Qt, please report it as described in http://doc.trolltech.com/bughowto.html. Good bug reports help us to help you. Thank you. The definitive Qt documentation is provided in HTML format; it is located at $QTDIR/doc/html and can be read using Qt Assistant or with a web browser. This man page is provided as a convenience for those users who prefer man pages, although this format is not officially supported by Trolltech. If you find errors in this manual page, please report them to qt-bugs@trolltech.com. Please include the name of the manual page (qdomdocumentfragment.3qt) and the Qt version (3.3.8).