XmlContainer::load

API Ref

#include <DbXml.hpp>

void XmlContainer::load(std::istream *in, unsigned long *lineno, u_int32_t flags=0);


Description: XmlContainer::load

The XmlContainer::load methods loads data from the specified stream into the container. The container's existing contents are discarded and replaced with the documents from the stream.

The container must be closed; the system throws an exception if the container is open.

The container must be have been opened at least once; the system throws an exception if the underlying files have not yet been created.

Parameters

lineno
The application uses lineno to specify the starting line number in the stream that is to be read. The system uses the same parameter to return the line number of the last line read from the stream.

flags
Not currently used.

Errors

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

CONTAINER_OPEN
The container is open.

DATABASE_ERROR
An error occurred in an underlying Berkeley DB database. The XmlException::getDbError method will return the error code for the error.

Class

XmlContainer, XmlDocument, XmlException, XmlIndexSpecification, XmlQueryContext, XmlQueryExpression, XmlResults, XmlUpdateContext, XmlValue

APIRef

Copyright (c) 1996-2003 Sleepycat Software, Inc. - All rights reserved.