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.
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
- iPosition
- Position in collection
-
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
- iPosition
- Position in collection