|
void write |
( |
const size_t |
recordCount | ) |
|
Request transfer of blocks of data to CompressedVectorNode from previously designated source buffers.
- Parameters:
-
[in] | recordCount | Number 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_REQUIRED | This CompressedVectorWriter in undocumented state, associated CompressedVectorNode modified but consistent, associated ImageFile modified but consistent. |
E57_ERROR_VALUE_OUT_OF_BOUNDS | This CompressedVectorWriter in undocumented state, associated CompressedVectorNode modified but consistent, associated ImageFile modified but consistent. |
E57_ERROR_VALUE_NOT_REPRESENTABLE | This CompressedVectorWriter in undocumented state, associated CompressedVectorNode modified but consistent, associated ImageFile modified but consistent. |
E57_ERROR_SCALED_VALUE_NOT_REPRESENTABLE | This CompressedVectorWriter in undocumented state, associated CompressedVectorNode modified but consistent, associated ImageFile modified but consistent. |
E57_ERROR_REAL64_TOO_LARGE | This CompressedVectorWriter in undocumented state, associated CompressedVectorNode modified but consistent, associated ImageFile modified but consistent. |
E57_ERROR_EXPECTING_NUMERIC | This CompressedVectorWriter in undocumented state, associated CompressedVectorNode modified but consistent, associated ImageFile modified but consistent. |
E57_ERROR_EXPECTING_USTRING | This CompressedVectorWriter in undocumented state, associated CompressedVectorNode modified but consistent, associated ImageFile modified but consistent. |
E57_ERROR_LSEEK_FAILED | This CompressedVectorWriter, associated ImageFile in undocumented state |
E57_ERROR_READ_FAILED | This CompressedVectorWriter, associated ImageFile in undocumented state |
E57_ERROR_WRITE_FAILED | This CompressedVectorWriter, associated ImageFile in undocumented state |
E57_ERROR_BAD_CHECKSUM | This CompressedVectorWriter, associated ImageFile in undocumented state |
E57_ERROR_INTERNAL | All objects in undocumented state |
- See also:
- SourceDestBufferNumericCreate.cpp example, CompressedVectorWriter::write(std::vector<SourceDestBuffer>&,unsigned), CompressedVectorNode::writer, CompressedVectorWriter::close, SourceDestBuffer, E57Exception
|