company logo

Property :: identityPath - Get property identity string

The function builds an identity string for a property in a structure instance. An identity string starts with the local (database) object identity (LOID) followed by a property path. The LOID is separated from the property path by '|'.

In contrast to an access path provided with hierarchyPath() , the property identity string addresses the instance not via access path, but by LOID.

If there is no instance selected in the property handle the function throws an exception.

  98765432|address.city

Return value:  Property identifier string ( odaba::String & )

A property identifier string is a string that identifies a property uniquely in the database:

loid|property_path [index]

The identifier string contains the local database identity (LOID) for the instance. property_path is the path that identifies a property within the instance. When the property is an array the element position is indicated by the index. Index numbers may also appear within the path (e.g. when supporting up to three addresses for a person a property path for "place" could look like:

199879899|address[2].place

In order to pass no identifier string, an empty string ( String() ) has to be passed.

Implementation details

odaba::String Property  :: identityPath (  )