Property :: extensionValue - Get extension value handle

Implementation overview

• Get extension value handle by name
  Property :: extensionValue ( sExtension )
• Get extension value handle by position
  Property :: extensionValue ( iPosition )

Implementation details

1. Get extension value handle by name
   odaba::Value & Property  :: extensionValue ( odaba::String &sExtension )
   

   The function returns a value handle for the property extension, when a property extension with the property name passed in sExtension has been stored for the instance currently selected in the property handle. When no property extension has been found, the function throws an exception. In order to check, whether the requested value exists, extensionExist() might be called.

   When the property name has been overloaded in the database, the extension property as being defined in the database will be searched. Otherwise, property extensions defined in either the dictionary or the database are searched for.

   Notes:

   Property extensions just being created are accessible via this function only, when the instance or property extension has been stored ( save() ).

   • sExtension - Extension property name

     Extension property are defined in a database or resource database using 40 byte character names ( ASCII or Latin1). Extension names are passed as String .

to list
2. Get extension value handle by position
   odaba::Value & Property  :: extensionValue ( int32 iPosition )
   

   The function returns a value handle for the property extension at position passed in iPosition . When no property extension has been stored at the position for the instance currently selected in the property handle, the function throws an exception. In order to check, whether the requested property exists, extensionCount() might be called.

   • iPosition - Position in collection

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

to list