Binary :: toInstance - Copy binary data to instance

The function copies data from the binary data area to an instance of a selected property to theand returns the size of data copied.

When the property handle is not selected, an initialized instance is provided. After copying, the instance is marked as modified.

Return value: Length ( int32 )

The length is the size allocated for an instance or area.

Implementation overview

Copy binary data to instance
Binary :: toInstance ( rProperty, iPosition )
Copy binary data to instance with passed length
Binary :: toInstance ( rProperty, iPosition, iLength )

Implementation details

Copy binary data to instance
int32 Binary :: toInstance ( odaba::Property &rProperty, int32 iPosition )

The function copies binary data at position passed in iPosition to the instance area of the property handle passed in rProperty with the instance length defined for the property handle.

When the position passed is beyond the end of the binary data area, no data is transferred and the function returns 0. When the remaining part in the binary data block is less than the defined instance length, the remaining part is copied and the size of copied data is returned.
- rProperty - Property reference
  A property handle refers to a (usually) opened property. Invalid properties may cause an exception.
- iPosition - Position in collection
  The position of an element in a collection is beginning with 0 for the first element.

Copy binary data to instance with passed length
int32 Binary :: toInstance ( odaba::Property &rProperty, int32 iPosition, int32 iLength )

The function copies binary data at position passed in iPosition to the instance area of the property handle passed in rProperty with the length passed in iLength. Passing 0 or a negative value in iLength will set the length to the instance size defined for the property handle. When iLength exceeds the instance size, it is set to instance size.

When the position passed is beyond the end of the binary data area, no data is transferred and the function returns 0. When the remaining part in the binary data block is less than iLength, the remaining part is copied and the size of copied data is returned.
- rProperty - Property reference
  A property handle refers to a (usually) opened property. Invalid properties may cause an exception.
- iPosition - Position in collection
  The position of an element in a collection is beginning with 0 for the first element.
- iLength - Length
  The length is the size allocated for an instance or area.