company logo

PropertyHandle :: ExistProperty - Check property path

The function checks, whether the property path passed is valid for the current type of the property handle. For checking properties in referenced instances, true must be passed in refr_opt. Otherwise, only properties in the current type and its base types are searched for.

Return value:  Return value ( logical  )

The function returns YES when the question was answered positively. Otherwise it returns NO.

Implementation details

logical PropertyHandle  :: ExistProperty ( NString &prop_path, logical refr_opt )
  • prop_path - Property path

    A property path is passed as 0-terminated string. It may contain an extent or property name but also a sequence of property names separated by dot.

    Property path may start with a dot (.), 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 the 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.

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

    address.street

    .address.street

  • refr_opt - Include references

    When this option is set to true, searching will include properties in reference properties