company logo

Binary :: mid - Get data section from binary data block

The function returns a data section from the current binary data block beginning at position iPosition.

When the iPosition exceeds the size of the current data block, the function returns an empty data block. When iPosition is less than zero 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

Implementation details

  1. Get data limited data section
    odaba::Binary Binary  :: mid ( int32 iPosition, int32 iCount )

    The function returns a data section from the current data block beginning at position iPosition.

    When there are less than iCount bytes available in the data block, or when iCount is -1, the function returns remaining data after specified position. When passing 0 in iCount the function returns an empty data block.
    • 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.
    2. to list
  2. Get remaining part of binary data block
    odaba::Binary Binary  :: mid ( int32 iPosition )

    The function returns the remaining part of the current data block beginning at iPosition.

    • iPosition - Position in collection

      The position of an element in a collection is beginning with 0 for the first element.
    3. to list
to top previous next upper table of contents Comment