# XmlContainer::parseXPathExpression

`

###

    #include <DbXml.hpp>

    XPathExpression
    XmlContainer::parseXPathExpression(
        const std::string &xpath, XmlQueryContext *context, u_int32_t flags);

# Description

Return a pre-parsed XPath 1.0 version query for later use with the XmlContainer::queryWithXPath method. The query is provided as a string and is expected to be in the syntax defined in the W3C XPath 1.0 specification.

The query may optionally be done within the execution context context, which describes how the query is to be performed.

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

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

# Errors

The XmlContainer::parseXPathExpression 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.

The XmlContainer::parseXPathExpression 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 XmlContainer::parseXPathExpression 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