#include <DbXml.hpp>

XmlStatistics XmlContainer::lookupStatistics(const std::string &uri,
    const std::string &name, const std::string &index,
    const XmlValue &value = XmlValue())

XmlStatistics XmlContainer::lookupStatistics(XmlTransaction &txn,
    const std::string &uri, const std::string &name,
    const std::string &index, const XmlValue &value = XmlValue())

XmlStatistics XmlContainer::lookupStatistics(const std::string &uri,
    const std::string &name, const std::string &parent_uri,
    const std::string &parent_name, const std::string &index,
    const XmlValue &value = XmlValue())

XmlStatistics XmlContainer::lookupStatistics(XmlTransaction &txn,
    const std::string &uri, const std::string &name,
    const std::string &parent_uri, const std::string &parent_name,
    const std::string &index, const XmlValue &value = XmlValue())

Returns an XmlStatistics object for the identified index. This object identifies the number of keys (both total and unique) maintained for the identified index.

Lookup statistics for the identified index. Note that this form of this method cannot be used to return statistics on edge indices.

• If the operation is to be transaction-protected, the txn parameter is an XmlTransaction handle returned from XmlManager::createTransaction.

• The namespace of the node to which this index is applied.

• The name of the node to which this index is applied.

• Identifies the index for which you want the statistics returned. The value supplied here must be a valid index. See XmlIndexSpecification::addIndex for a description of valid index specifications.

• Provides the value to which equality indices must be equal. This parameter is required when returning statistics on equality indices, and it is ignored for all other types of indices.

The XmlContainer::lookupStatistics method may fail and throw XmlException, encapsulating one of the following non-zero errors:

• Unknown index specification

Lookup statistics for the identified index. Use this form of this method to return statistics on edge indices.

Edge indices are indices maintained for those locations in a document where two nodes (a parent node and a child node) meet. See the Berkeley DB XML Getting Started Guide for details.

• If the operation is to be transaction-protected, the txn parameter is an XmlTransaction handle returned from XmlManager::createTransaction.

• The namespace of the node to which this edge index is applied.

• The name of the node to which this edge index is applied.

• The namespace of the parent node to which this edge index is applied.

• The name of the parent node to which this edge index is applied.

• Identifies the index for which you want the statistics returned. The value supplied here must be a valid index. See XmlIndexSpecification::addIndex for a description of valid index specifications.

• Provides the value to which equality indices must be equal. This parameter is required when returning statistics on equality indices, and it is ignored for all other types of indices.

The XmlContainer::lookupStatistics method may fail and throw XmlException, encapsulating one of the following non-zero errors:

• Unknown index specification