Qt 4.8: QXmlStreamAttributes Class Reference

Qt Reference Documentation

- Qt 4.8
- ALL VERSIONS

- A
- A
- A
- Print

# QXmlStreamAttributes Class Reference

The QXmlStreamAttributes class represents a vector of QXmlStreamAttribute. More...

     #include <QXmlStreamAttributes>

Inherits: QVector<QXmlStreamAttribute>.

Note: All functions in this class are reentrant.

This class was introduced in Qt 4.3.

- List of all members, including inherited members

## Public Functions

| QXmlStreamAttributes ()
void | append ( const QString & namespaceUri, const QString & name, const QString & value )
void | append ( const QXmlStreamAttribute & attribute )
void | append ( const QString & qualifiedName, const QString & value )
bool | hasAttribute ( const QString & qualifiedName ) const
bool | hasAttribute ( const QLatin1String & qualifiedName ) const
bool | hasAttribute ( const QString & namespaceUri, const QString & name ) const
QStringRef | value ( const QString & namespaceUri, const QString & name ) const
QStringRef | value ( const QString & namespaceUri, const QLatin1String & name ) const
QStringRef | value ( const QLatin1String & namespaceUri, const QLatin1String & name ) const
QStringRef | value ( const QString & qualifiedName ) const
QStringRef | value ( const QLatin1String & qualifiedName ) const

- 65 public functions inherited from QVector

### Additional Inherited Members

- 2 static public members inherited from QVector

## Detailed Description

The QXmlStreamAttributes class represents a vector of QXmlStreamAttribute.

Attributes are returned by a QXmlStreamReader in attributes() when the reader reports a start element. The class can also be used with a QXmlStreamWriter as an argument to writeAttributes().

The convenience function value() loops over the vector and returns an attribute value for a given namespaceUri and an attribute's name.

New attributes can be added with append().

## Member Function Documentation

### QXmlStreamAttributes::QXmlStreamAttributes ()

### void QXmlStreamAttributes::append ( const QString & namespaceUri, const QString & name, const QString & value )

Appends a new attribute with name in the namespace described with namespaceUri, and value value. The namespaceUri can be empty.

### void QXmlStreamAttributes::append ( const QXmlStreamAttribute & attribute )

Appends the given attribute to the end of the vector.

See also QVector::append().

### void QXmlStreamAttributes::append ( const QString & qualifiedName, const QString & value )

This is an overloaded function.

Appends a new attribute with qualified name qualifiedName and value value.

### bool QXmlStreamAttributes::hasAttribute ( const QString & qualifiedName ) const

Returns true if this QXmlStreamAttributes has an attribute whose qualified name is qualifiedName; otherwise returns false.

Note that this is not namespace aware. For instance, if this QXmlStreamAttributes contains an attribute whose lexical name is "xlink:href" this doesn't tell that an attribute named `href` in the XLink namespace is present, since the `xlink` prefix can be bound to any namespace. Use the overload that takes a namespace URI and a local name as parameter, for namespace aware code.

This function was introduced in Qt 4.5.

### bool QXmlStreamAttributes::hasAttribute ( const QLatin1String & qualifiedName ) const

This is an overloaded function.

This function was introduced in Qt 4.5.

### bool QXmlStreamAttributes::hasAttribute ( const QString & namespaceUri, const QString & name ) const

This is an overloaded function.

Returns true if this QXmlStreamAttributes has an attribute whose namespace URI and name correspond to namespaceUri and name; otherwise returns false.

This function was introduced in Qt 4.5.

### QStringRef QXmlStreamAttributes::value ( const QString & namespaceUri, const QString & name ) const

Returns the value of the attribute name in the namespace described with namespaceUri, or an empty string reference if the attribute is not defined. The namespaceUri can be empty.

### QStringRef QXmlStreamAttributes::value ( const QString & namespaceUri, const QLatin1String & name ) const

This is an overloaded function.

Returns the value of the attribute name in the namespace described with namespaceUri, or an empty string reference if the attribute is not defined. The namespaceUri can be empty.

### QStringRef QXmlStreamAttributes::value ( const QLatin1String & namespaceUri, const QLatin1String & name ) const

This is an overloaded function.

Returns the value of the attribute name in the namespace described with namespaceUri, or an empty string reference if the attribute is not defined. The namespaceUri can be empty.

### QStringRef QXmlStreamAttributes::value ( const QString & qualifiedName ) const

This is an overloaded function.

Returns the value of the attribute with qualified name qualifiedName , or an empty string reference if the attribute is not defined. A qualified name is the raw name of an attribute in the XML data. It consists of the namespace prefix, followed by colon, followed by the attribute's local name. Since the namespace prefix is not unique (the same prefix can point to different namespaces and different prefixes can point to the same namespace), you shouldn't use qualified names, but a resolved namespaceUri and the attribute's local name.

### QStringRef QXmlStreamAttributes::value ( const QLatin1String & qualifiedName ) const

This is an overloaded function.

Returns the value of the attribute with qualified name qualifiedName , or an empty string reference if the attribute is not defined. A qualified name is the raw name of an attribute in the XML data. It consists of the namespace prefix, followed by colon, followed by the attribute's local name. Since the namespace prefix is not unique (the same prefix can point to different namespaces and different prefixes can point to the same namespace), you shouldn't use qualified names, but a resolved namespaceUri and the attribute's local name.