E57 Foundation API v1.1.312  Aug. 10, 2011
CompressedVectorReader reader ( const std::vector< SourceDestBuffer > &  dbufs)

Create an iterator object for reading a series of blocks of data from a CompressedVectorNode.

Parameters:
[in]dbufsVector of memory buffers that will receive data read from a CompressedVectorNode.

The pathNames in the dbufs must identify terminal nodes (i.e. node that can have no children: IntegerNode, ScaledIntegerNode, FloatNode, StringNode) in this CompressedVectorNode's prototype. It is an error for two SourceDestBuffers in dbufs to identify the same terminal node in the prototype. It is not an error to create a CompressedVectorReader for an empty CompressedVectorNode.

Precondition:
dbufs can't be empty
The destination ImageFile must be open (i.e. destImageFile().isOpen()).
The destination ImageFile can't have any writers open (destImageFile().writerCount()==0)
This CompressedVectorNode must be attached (i.e. isAttached()).
Returns:
A smart CompressedVectorReader handle referencing the underlying iterator object.
Exceptions:
E57_ERROR_BAD_API_ARGUMENT
E57_ERROR_IMAGEFILE_NOT_OPEN
E57_ERROR_TOO_MANY_WRITERS
E57_ERROR_NODE_UNATTACHED
E57_ERROR_PATH_UNDEFINED
E57_ERROR_BUFFER_SIZE_MISMATCH
E57_ERROR_BUFFER_DUPLICATE_PATHNAME
E57_ERROR_BAD_CV_HEADER
E57_ERROR_INTERNALAll objects in undocumented state
See also:
SourceDestBufferFunctions.cpp example, CompressedVectorReader, SourceDestBuffer, CompressedVectorNode::CompressedVectorNode, CompressedVectorNode::prototype
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Defines