company logo

Property :: cursorEquals - Is property handle the same

The function compares the property handle cursors referenced in the property handles. When the cursors in both property handles are the same, the function returns true , false otherwise.

Property handles will share the cursor, when being created by assigning property handles or by calling use() . Property handles do not share the cursor, when being opened with cursorCopy () .

The cursor in the property handle may change for subordinated property handles, when the parent property handle is weak-typed or untyped. The cursor is updated before comparing.

The property throws an exception, when the calling property handle is not valid.

Return value:  Success ( bool  )

The value is true when the function was executed successfully. Otherwise the value is set to false .

Implementation details

bool Property  :: cursorEquals ( odaba::Property &cProperty )
  • cProperty - Property reference

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