Binary :: update - Update binary data block

The function updates the binary data block at position passed in iPosition. When the position is beyond the data block end, the data block will be expanded by padding extended area with 0. When appending 0 bytes by passing an empty data block or a count value 0, nothing will be appended but the data block might be expanded up to the position value passed in iPosition.

When position or count value become negative, the function throws an exception.

Return value: Binary data block handle ( odaba::Binary & )

Constant reference to a binary data block handle, which may contain binary data up to 2 GB.

Implementation overview

Update data block with byte value
Binary :: update ( iPosition, iValue, iCount )
Update binary data block
Binary :: update ( iPosition, cBinary )

Implementation details

Update data block with byte value
odaba::Binary & Binary :: update ( int32 iPosition, int32 iValue, int32 iCount )

The function iCount times writes the byte value passed in iValue at position iPosition. iValue must not be below 0 and above 255. Otherwise, the function throws an exception.
- iPosition - Position in collection
  The position of an element in a collection is beginning with 0 for the first element.
- iValue - Integer value
  The value is passed as platform independent 32-bit integer value.
- iCount - Number of items
  The value contains the number of items to be processed or stored in a collection.

to list

Update binary data block
odaba::Binary & Binary :: update ( int32 iPosition, odaba::Binary &cBinary )

The function overwrites the binary data block with binary data passed in cBinary at position iPosition.
- iPosition - Position in collection
  The position of an element in a collection is beginning with 0 for the first element.
- cBinary - Binary data block handle
  Constant reference to a binary data block handle, which may contain binary data up to 2 GB.

to list

to top Comment