# XmlDocument::setAttributeValue

`

###

    #include <DbXml.hpp>

    void
    XmlDocument::setAttributeValue(const std::string &attr,
        const std::string &value, u_int32_t flags);

# Description

The XmlDocument::setAttributeValue method sets the value of the specified attr annotation attribute. The only values supported are Strings.

The flags parameter is currently unused, and must be set to 0.

The XmlDocument::setAttributeValue method throws an exception that encapsulates a non-zero error value on failure.

# Errors

The XmlDocument::setAttributeValue method may fail and throw an exception encapsulating a non-zero error for the following conditions:

EINVAL
  An invalid flag value or parameter was specified.

If the requested item could not be returned due to insufficient memory, the XmlDocument::setAttributeValue method will fail and throw a DbMemoryException exception.

The XmlDocument::setAttributeValue method may fail and throw an exception for errors specified for other Berkeley DB and C library or system methods. If a catastrophic error has occurred, the XmlDocument::setAttributeValue method may fail and throw a DbRunRecoveryException, in which case all subsequent Berkeley DB calls will fail in the same way.

# Class

XmlContainer, XmlDocument, XmlQueryContext

# See Also

XmlContainer::close, XmlContainer::declareIndex, XmlContainer::deleteDocument, XmlContainer::getDocument, XmlContainer::getName, XmlContainer::open, XmlContainer::putDocument and XmlContainer::queryWithXPath.

XmlDocument::getAttributeValue, XmlDocument::getContent, XmlDocument::getID, XmlDocument::getName, XmlDocument::getType, XmlDocument::setContent, XmlDocument::setName, and XmlDocument::setType.

`

Copyright Sleepycat Software