company logo

Property :: hierarchyPath - Get Accesspath for property handle hierarchy

The function returns the complete hierarchy path (properties and selections) or the path between two peoperties.
Return value:  Access path ( odaba::String & )

An access path may simply refer to an extent or property, but also to a calculated result. Thus, an access path may contain just a name, but also a sequence of path elements separated by '.' in order to refer to far properties or complex operations.

The access path may start with two dots (.), which indicates, that the path starts in an upper property handle. One dot indicates, that the path starts in the current property handle. This distinction becomes necessary, when a property has the same name as an extent. To access a property in this case, one dot must precede the property name. The first dot can be omitted, when the property name is not an extent name.

Forcing to a path to start in a parent property handle requires two dots (..), the parents parent three and so on.

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

address.street      // property path

.address.street     // property path

..address.street    // address in parent property instance

children(0).Age()   // operation path

Person().children() // path property

children('Anton')   // path property

Implementation overview

Implementation details

  1. Get complete property path
    odaba::String Property  :: hierarchyPath (  )

    The function returns the complete property path for the current property handle.
    2. to list
  2. Get hierarchy path to upper property
    odaba::String Property  :: hierarchyPath ( odaba::Property &cProperty )

    The function returns the path between the current property handle and the passed property handle. The current property handle must be a sub handle of the upper handle passed to the function. When an invalid property handle is passed as upper handle, the function throws a exception.

    The path returned can be used to reopen the current

    • cProperty - Property reference

      A property handle refers to a (usually) opened property. Invalid properties may cause an exception.
    3. to list
to top previous next upper table of contents Comment