company logo

PropertyHandle :: Select - Create a subset from a collection

The result collection contains the instances from the passed collection that return true (YES) for the expression passed to the select function. The expression passed must define a valid expression for the structure of the passed collection.

The operation is performed with the passed operand storing the result in the collection referenced by the calling property handle. When the calling property handle refers to a non empty collection all instances are removed before performing the operation. When the calling property handle is empty the function creates a temporary extend for storing the result.

Return value:  Result property handle (   )

Reference to the property handle that contains the result of an operation (usually the calling property handle).

Implementation details

PropertyHandle & PropertyHandle  :: Select ( PropertyHandle &prophdl_ref, NString &cexpression )
  • prophdl_ref - Reference to Property handle
  • cexpression - - Title unknown