E57 Foundation API v1.1.312  Aug. 10, 2011
void write ( const size_t  recordCount)

Request transfer of blocks of data to CompressedVectorNode from previously designated source buffers.

Parameters:
[in]recordCountNumber of records to write.

The SourceDestBuffers used are previously designated either in CompressedVectorNode::writer where this object was created, or in the last call to CompressedVectorWriter::write(std::vector<SourceDestBuffer>&, unsigned) where new buffers were designated.

If a conversion or bounds error occurs during the transfer, the CompressedVectorWriter is left in an undocumented state (it can't be used any further), and all previously written records are deleted from the associated CompressedVectorNode which will then have zero children. If a file I/O or checksum error occurs during the transfer, both this CompressedVectorWriter and the associated ImageFile are left in an undocumented state (they can't be used any further). If CompressedVectorWriter::close is not called before the CompressedVectorWriter destructor is invoked, all writes to the CompressedVectorNode will be lost (it will have zero children).

Precondition:
The associated ImageFile must be open.
This CompressedVectorWriter must be open (i.e isOpen())
Exceptions:
E57_ERROR_BAD_API_ARGUMENT
E57_ERROR_IMAGEFILE_NOT_OPEN
E57_ERROR_WRITER_NOT_OPEN
E57_ERROR_PATH_UNDEFINED
E57_ERROR_NO_BUFFER_FOR_ELEMENT
E57_ERROR_BUFFER_SIZE_MISMATCH
E57_ERROR_BUFFER_DUPLICATE_PATHNAME
E57_ERROR_CONVERSION_REQUIREDThis CompressedVectorWriter in undocumented state, associated CompressedVectorNode modified but consistent, associated ImageFile modified but consistent.
E57_ERROR_VALUE_OUT_OF_BOUNDSThis CompressedVectorWriter in undocumented state, associated CompressedVectorNode modified but consistent, associated ImageFile modified but consistent.
E57_ERROR_VALUE_NOT_REPRESENTABLEThis CompressedVectorWriter in undocumented state, associated CompressedVectorNode modified but consistent, associated ImageFile modified but consistent.
E57_ERROR_SCALED_VALUE_NOT_REPRESENTABLEThis CompressedVectorWriter in undocumented state, associated CompressedVectorNode modified but consistent, associated ImageFile modified but consistent.
E57_ERROR_REAL64_TOO_LARGEThis CompressedVectorWriter in undocumented state, associated CompressedVectorNode modified but consistent, associated ImageFile modified but consistent.
E57_ERROR_EXPECTING_NUMERICThis CompressedVectorWriter in undocumented state, associated CompressedVectorNode modified but consistent, associated ImageFile modified but consistent.
E57_ERROR_EXPECTING_USTRINGThis CompressedVectorWriter in undocumented state, associated CompressedVectorNode modified but consistent, associated ImageFile modified but consistent.
E57_ERROR_LSEEK_FAILEDThis CompressedVectorWriter, associated ImageFile in undocumented state
E57_ERROR_READ_FAILEDThis CompressedVectorWriter, associated ImageFile in undocumented state
E57_ERROR_WRITE_FAILEDThis CompressedVectorWriter, associated ImageFile in undocumented state
E57_ERROR_BAD_CHECKSUMThis CompressedVectorWriter, associated ImageFile in undocumented state
E57_ERROR_INTERNALAll objects in undocumented state
See also:
SourceDestBufferNumericCreate.cpp example, CompressedVectorWriter::write(std::vector<SourceDestBuffer>&,unsigned), CompressedVectorNode::writer, CompressedVectorWriter::close, SourceDestBuffer, E57Exception
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Defines