XmlContainer::deleteDocument

API Ref

#include <DbXml.hpp>

void XmlContainer::deleteDocument(const std::string name, XmlUpdateContext &context)

void XmlContainer::deleteDocument(XmlDocument &document, XmlUpdateContext &context)

void XmlContainer::deleteDocument(XmlTransaction &txn, const std::string name, XmlUpdateContext &context)

void XmlContainer::deleteDocument(XmlTransaction &txn, XmlDocument &document, XmlUpdateContext &context)


Description: XmlContainer::deleteDocument

The XmlContainer::deleteDocument method removes the specified XmlDocument from the XmlContainer.


Description: void XmlContainer::deleteDocument(XmlTransaction &txn, const std::string name, XmlUpdateContext &context)

Delete the document with the given name.

Parameters

txn
If the operation is to be transaction-protected, the txn parameter is an XmlTransaction handle returned from XmlManager::createTransaction.
name
The name of the XmlDocument to be deleted from the container.
context
The XmlUpdateContext object to use for this deletion.

Errors

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

DATABASE_ERROR
An error occurred in an underlying Berkeley DB database. The XmlException::getDbErrno method will return the error code for the error.
DOCUMENT_NOT_FOUND
The specified document is not in the XmlContainer.

Description: void XmlContainer::deleteDocument(XmlTransaction &txn, XmlDocument &document, XmlUpdateContext &context)

Removes the specified XmlDocument from the XmlContainer.

Parameters

txn
If the operation is to be transaction-protected, the txn parameter is an XmlTransaction handle returned from XmlManager::createTransaction.
document
The XmlDocument to be deleted from the container. The name to be deleted is extracted from this parameter.
context
The XmlUpdateContext object to use for this deletion.

Errors

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

DATABASE_ERROR
An error occurred in an underlying Berkeley DB database. The XmlException::getDbErrno method will return the error code for the error.
DOCUMENT_NOT_FOUND
The specified document is not in the XmlContainer.

APIRef

Copyright (c) 1996,2007 Oracle. All rights reserved.