company logo

Property :: moveDown - Move instance down

The position of an instance can be moved down in an unordered collection or in a collection with an __AUTOIDENT access key. Moving the instance down in an unordered collection will change the position of the instance, only. Moving an instance down in a collection with an __AUTOIDENT access key will update the value in the __AUTOIDENT attribute of the instance.

The function moves the positioned instance the requested number of positions downwards in the collection.

The function will throw an exception when being called for any other type of collection or when the property handle is not positioned.

Return value:  Property reference ( odaba::Property & )

A property handle refers to a (usually) opened property. Invalid properties may cause an exception.

Implementation overview

Implementation details

  1. Move down
    odaba::Property & Property  :: moveDown ( int32 iCount )

    The function moves the currently positioned instance iCount positions downwards in the collection. When iCount is negative or larger than the number of possible positions it can move down, the instance will be moved to the end of the collection.

    • iCount - Number of items

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

  2. to list
  3. Move down one position
    odaba::Property & Property  :: moveDown (  )

    The function moves the currently positioned instance 1 position downwards in the collection.

  4. to list