company logo

Binary :: erase - Erase bytes from data block

The function removes iCount bytes from the binary data block, starting at position passed in iPosition, and returns a reference to the binary data block handle.

When the specified position is within the data block, but iPosition + iCount is beyond the end of the data block, the data block is truncated at the specified position.

When the specified position is not within the data block, the function does nothing. When iCount is less than zero or iPosition is less than zerothe 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 details

odaba::Binary & Binary  :: erase ( int32 iPosition, int32 iCount )
  • iPosition - Position in collection

    The position of an element in a collection is beginning with 0 for the first element.

  • iCount - Number of items

    The value contains the number of items to be processed or stored in a collection.