From d796c9dd933ab96ec83b9a634feedd5d32e1ba3f Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Tue, 8 Nov 2011 12:31:36 -0600 Subject: Test conversion to TQt3 from Qt3 8c6fc1f8e35fd264dd01c582ca5e7549b32ab731 --- doc/html/qxmlnamespacesupport.html | 201 +++++++++++++++++++++++++++++++++++++ 1 file changed, 201 insertions(+) create mode 100644 doc/html/qxmlnamespacesupport.html (limited to 'doc/html/qxmlnamespacesupport.html') diff --git a/doc/html/qxmlnamespacesupport.html b/doc/html/qxmlnamespacesupport.html new file mode 100644 index 000000000..8c09edc9a --- /dev/null +++ b/doc/html/qxmlnamespacesupport.html @@ -0,0 +1,201 @@ + + + + + +TQXmlNamespaceSupport Class + + + + + + + +
+ +Home + | +All Classes + | +Main Classes + | +Annotated + | +Grouped Classes + | +Functions +

TQXmlNamespaceSupport Class Reference
[XML module]

+ +

The TQXmlNamespaceSupport class is a helper class for XML +readers which want to include namespace support. +More... +

All the functions in this class are reentrant when TQt is built with thread support.

+

#include <qxml.h> +

List of all member functions. +

Public Members

+ +

Detailed Description

+ + + +The TQXmlNamespaceSupport class is a helper class for XML +readers which want to include namespace support. + +

+ +

You can set the prefix for the current namespace with setPrefix(), +and get the list of current prefixes (or those for a given URI) +with prefixes(). The namespace URI is available from uri(). Use +pushContext() to start a new namespace context, and popContext() +to return to the previous namespace context. Use splitName() or +processName() to split a name into its prefix and local name. +

See also the namespace description. +

See also XML. + +

Member Function Documentation

+

TQXmlNamespaceSupport::TQXmlNamespaceSupport () +

+Constructs a TQXmlNamespaceSupport. + +

TQXmlNamespaceSupport::~TQXmlNamespaceSupport () +

+Destroys a TQXmlNamespaceSupport. + +

void TQXmlNamespaceSupport::popContext () +

+Reverts to the previous namespace context. +

Normally, you should pop the context at the end of each XML +element. After popping the context, all namespace prefix mappings +that were previously in force are restored. +

See also pushContext(). + +

TQString TQXmlNamespaceSupport::prefix ( const TQString & uri ) const +

+Returns one of the prefixes mapped to the namespace URI uri. +

If more than one prefix is currently mapped to the same URI, this +function makes an arbitrary selection; if you want all of the +prefixes, use prefixes() instead. +

Note: to check for a default prefix, use the uri() function with +an argument of "". + +

TQStringList TQXmlNamespaceSupport::prefixes () const +

+Returns a list of all the prefixes currently declared. +

If there is a default prefix, this function does not return it in +the list; check for the default prefix using uri() with an +argument of "". +

Note that if you want to iterate over the list, you should iterate +over a copy, e.g. +

+    TQStringList list = myXmlNamespaceSupport.prefixes();
+    TQStringList::iterator it = list.begin();
+    while ( it != list.end() ) {
+        myProcessing( *it );
+        ++it;
+    }
+
+ + +

TQStringList TQXmlNamespaceSupport::prefixes ( const TQString & uri ) const +

+This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +

Returns a list of all prefixes currently declared for the +namespace URI uri. +

The "xml:" prefix is included. If you only want one prefix that is +mapped to the namespace URI, and you don't care which one you get, +use the prefix() function instead. +

Note: the empty (default) prefix is never included in this list; +to check for the presence of a default namespace, use uri() with +an argument of "". +

Note that if you want to iterate over the list, you should iterate +over a copy, e.g. +

+    TQStringList list = myXmlNamespaceSupport.prefixes( "" );
+    TQStringList::Iterator it = list.begin();
+    while( it != list.end() ) {
+        myProcessing( *it );
+        ++it;
+    }
+
+ + +

void TQXmlNamespaceSupport::processName ( const TQString & qname, bool isAttribute, TQString & nsuri, TQString & localname ) const +

+Processes a raw XML 1.0 name in the current context by removing +the prefix and looking it up among the prefixes currently +declared. +

qname is the raw XML 1.0 name to be processed. isAttribute +is TRUE if the name is an attribute name. +

This function stores the namespace URI in nsuri (which will be +set to TQString::null if the raw name has an undeclared prefix), +and stores the local name (without prefix) in localname (which +will be set to TQString::null if no namespace is in use). +

Note that attribute names are processed differently than element +names: an unprefixed element name gets the default namespace (if +any), while an unprefixed element name does not. + +

void TQXmlNamespaceSupport::pushContext () +

+Starts a new namespace context. +

Normally, you should push a new context at the beginning of each +XML element: the new context automatically inherits the +declarations of its parent context, and it also keeps track of +which declarations were made within this context. +

See also popContext(). + +

void TQXmlNamespaceSupport::reset () +

+Resets this namespace support object ready for reuse. + +

void TQXmlNamespaceSupport::setPrefix ( const TQString & pre, const TQString & uri ) +

+This function declares a prefix pre in the current namespace +context to be the namespace URI uri. The prefix remains in +force until this context is popped, unless it is shadowed in a +descendant context. +

Note that there is an asymmetry in this library. prefix() does not +return the default "" prefix, even if you have declared one; to +check for a default prefix, you must look it up explicitly using +uri(). This asymmetry exists to make it easier to look up prefixes +for attribute names, where the default prefix is not allowed. + +

void TQXmlNamespaceSupport::splitName ( const TQString & qname, TQString & prefix, TQString & localname ) const +

+Splits the name qname at the ':' and returns the prefix in prefix and the local name in localname. +

See also processName(). + +

TQString TQXmlNamespaceSupport::uri ( const TQString & prefix ) const +

+Looks up the prefix prefix in the current context and returns +the currently-mapped namespace URI. Use the empty string ("") for +the default namespace. + + +

+This file is part of the TQt toolkit. +Copyright © 1995-2007 +Trolltech. All Rights Reserved.

+ +
Copyright © 2007 +TrolltechTrademarks +
TQt 3.3.8
+
+ -- cgit v1.2.1