Namespace Sax
Class CAttributesImpl

class CAttributesImpl: public CAttributes {
public:
    CAttributesImpl();
    CAttributesImpl(const XAttributes &pAtts);
    ~CAttributesImpl();
public:
    int GetLength();
    CString GetUri(int nIndex);
    CString GetLocalName(int nIndex);
    CString GetQName(int nIndex);
    CString GetType(int nIndex);
    CString GetValue(int nIndex);
    int GetIndex(
        const CString &strUri, 
        const CString &strLocalName);
    int GetIndex(const CString &strQName);
    CString GetType(
        const CString &strUri,
        const CString &strLocalName);
    CString GetType(const CString &strQName);
    CString GetValue(
        const CString &strUri,
        const CString &strLocalName);
    CString GetValue(const CString &strQName);
public:
    void Clear();
    void SetAttributes(const XAttributes &pAtts);
    void AddAttribute(
        const CString &strUri,
        const CString &strLocalName,
        const CString &strQName,
        const CString &strType,
        const CString &strValue);
    void SetAttribute(
        int nIndex,
        const CString &strUri,
        const CString &strLocalName,
        const CString &strQName,
        const CString &strType,
        const CString &strValue);
    void RemoveAttribute(int nIndex);
    void SetUri(int nIndex, const CString &strUri);
    void SetLocalName(int nIndex, const CString &strLocalName);
    void SetQName(int nIndex, const CString &strQName);
    void SetType(int nIndex, const CString &strType);
    void SetValue(int nIndex, const CString &strValue);
    };

The default implementation of lists of XML attributes.

This class provides the default implementation to the interface specified by the CAttributes class, with the addition of manipulators so that lists of attributes can be modified or reused.

There are two typical uses of this class:

• to take a persistent snapshot of a CAttributes object in a CContentHandler::StartElement event; or
• to construct or modify an CAttributes object in a SAX2 reader or filter.

Since:

1.00.00

Version:

1.00.00

Author:

C++ interfaces by Alexey Gokhberg; based on the original SAX2 specification by David Megginson

See Also:

CAttributes

CAttributesImpl

CAttributesImpl();

Constructs the empty list of attributes.

CAttributesImpl

CAttributesImpl(const XAttributes &pAtts);

Constructs the list of attributes, copying an existing CAttributes object.

This constructor might be especially useful inside a CContentHandler::StartElement event.

Parameters:

pAtts - the existing list of attributes

~CAttributesImpl

~CAttributesImpl();

Destroys the list of attributes.

GetLength

int GetLength();

Gets the number of attributes in this list.

Once you know the number of attributes, you can iterate through the list.

Returns:

the number of attributes in this list

GetUri

CString GetUri(int nIndex);

Looks up an attribute's namespace URI by index.

Parameters:

nIndex - the attribute index (zero-based)

Returns:

the namespace URI, or the empty string if none is available or if the index is out of range

GetLocalName

CString GetLocalName(int nIndex);

Looks up an attribute's local name by index.

Parameters:

nIndex - the attribute index (zero-based)

Returns:

the local name, or the empty string if namespace processing is not being performed or if the index is out of range

GetQName

CString GetQName(int nIndex);

Looks up an attribute's XML 1.0 qualified name by index.

Parameters:

nIndex - the attribute index (zero-based)

Returns:

the XML 1.0 qualified name, or the empty string if none is available or if the index is out of range

GetType

CString GetType(int nIndex);

Looks up an attribute's type by index.

The attribute type is one of the strings "CDATA" , "ID" , "IDREF" , "IDREFS" , "NMTOKEN" , "NMTOKENS" , "ENTITY" , "ENTITIES" , or "NOTATION" (always in upper case).

If the reader has not read a declaration for the attribute, or if the reader does not report attribute types, then it must return the value "CDATA" as stated in the XML 1.0 Recommentation (clause 3.3.3, "Attribute-Value Normalization").

For an enumerated attribute that is not a notation, the reader will report the type as "NMTOKEN" .

Parameters:

nIndex - the attribute index (zero-based)

Returns:

the attribute's type as a string, or the empty string if the index is out of range

GetValue

CString GetValue(int nIndex);

Looks up an attribute's value by index.

If the attribute value is a list of tokens ( IDREFS , ENTITIES , or NMTOKENS ), the tokens will be concatenated into a single string with each token separated by a single space.

Parameters:

nIndex - the attribute index (zero-based)

Returns:

the attribute's value as a string, or the empty string if the index is out of range

GetIndex

int GetIndex(
    const CString &strUri, 
    const CString &strLocalName);

Looks up the index of an attribute by namespace name.

Parameters:

strUri - the namespace URI, or the empty string if the name has no namespace URI

strLocalName - the attribute's local name

Returns:

the index of the attribute, or -1 if it does not appear in the list

GetIndex

int GetIndex(const CString &strQName);

Looks up the index of an attribute by XML 1.0 qualified name.

Parameters:

strQName - the qualified (prefixed) name

Returns:

the index of the attribute, or -1 if it does not appear in the list

GetType

CString GetType(
    const CString &strUri,
    const CString &strLocalName);

Looks up an attribute's type by namespace name.

Parameters:

strUri - the namespace URI, or the empty string if the name has no namespace URI

strLocalName - the attribute's local name

Returns:

the attribute type as a string, or the empty string if the attribute is not in the list or if namespace processing is not being performed

GetType

CString GetType(const CString &strQName);

Looks up an attribute's type by XML 1.0 qualified name.

Parameters:

strQName - the qualified (prefixed) name

Returns:

the attribute type as a string, or the empty string if the attribute is not in the list or if qualified names are not available

GetValue

CString GetValue(
    const CString &strUri,
    const CString &strLocalName);

Looks up an attribute's value by namespace name.

Parameters:

strUri - the namespace URI, or the empty string if the name has no namespace URI

strLocalName - the attribute's local name

Returns:

the attribute value as a string, or the empty string if the attribute is not in the list

GetValue

CString GetValue(const CString &strQName);

Looks up an attribute's value by XML 1.0 qualified name.

Parameters:

strQName - the qualified (prefixed) name

Returns:

the attribute value as a string, or the empty string if the attribute is not in the list or if qualified names are not available

Clear

void Clear();

Clears the attribute list for reuse.

SetAttributes

void SetAttributes(const XAttributes &pAtts);

Copies an entire attribute list.

Parameters:

pAtts - the attribute list to copy

AddAttribute

void AddAttribute(
    const CString &strUri,
    const CString &strLocalName,
    const CString &strQName,
    const CString &strType,
    const CString &strValue);

Adds the attribute to the end of the list.

Parameters:

strUri - the namespace URI, or the empty string if none is available or namespace processing is not being performed

strLocalName - the local name, or the empty string if namespace processing is not being performed

strQName - the qualified (prefixed) name, or the empty string if qualified names are not available

strType - the attribute type as a string

strValue - the attribute value

SetAttribute

void SetAttribute(
    int nIndex,
    const CString &strUri,
    const CString &strLocalName,
    const CString &strQName,
    const CString &strType,
    const CString &strValue);

Sets an attribute in the list.

Parameters:

nIndex - the index of the attribute (zero-based)

strUri - the namespace URI, or the empty string if none is available or namespace processing is not being performed

strLocalName - the local name, or the empty string if namespace processing is not being performed

strQName - the qualified name, or the empty string if qualified names are not available

strType - the attribute type as a string

strValue - the attribute value

RemoveAttribute

void RemoveAttribute(int nIndex);

Removes an attribute from this list.

Parameters:

nIndex - the index of the attribute (zero-based)

SetUri

void SetUri(int nIndex, const CString &strUri);

Sets the namespace URI of a specific attribute.

Parameters:

nIndex - the index of the attribute (zero-based)

strUri - the attribute's namespace URI, or the empty string for none

SetLocalName

void SetLocalName(int nIndex, const CString &strLocalName);

Sets the local name of a specific attribute.

Parameters:

nIndex - the index of the attribute (zero-based)

strLocalName - the attribute's local name, or the empty string for none

SetQName

void SetQName(int nIndex, const CString &strQName);

Sets the qualified name of a specific attribute.

Parameters:

nIndex - the index of the attribute (zero-based)

strLocalName - the attribute's qualified name, or the empty string for none

SetType

void SetType(int nIndex, const CString &strType);

Sets the type of a specific attribute.

Parameters:

nIndex - the index of the attribute (zero-based)

strType - the attribute's type

SetValue

void SetValue(int nIndex, const CString &strValue);

Sets the value of a specific attribute.

Parameters:

nIndex - the index of the attribute (zero-based)

strType - the attribute's value