occpGetBestProp

occpGetBestProp(
o_occpHandle 
h_pathVectorId 
t_propName
)
=> r_occpProp / nil

Description

Gets the property information with the highest precedence for the specified occurrence path. The information is based on the occurrence path, the iterated instance, the instance, the cell, and the default properties with the specified name.

Arguments

o_occpHandle	The properties file handle returned from a call to occpOpen.
h_pathVectorId	The occurrence path for the property as returned from a call to hdbCreatePathVector.
t_propName	The name of the property.

Value Returned

r_occpProp	The property name structure, as returned by occpCreateProp.
nil	The property information does not exist or could not be retrieved.

Example

MyHdbHandle = hdbOpen("lib1" "cell1" "cfgView1" "r" "CDBA")
when( MyHdbHandle
    MyOccpHandle = occpOpen("lib1" "cell1" "cfgView1" "r" "CDBA")
    when( MyOccpHandle
     MyPathVec = hdbCreatePathVector(MyHdbHandle)
  hdbPushCell(MyPathVec "I42"
   hdbGetTopLibName(MyHdbHandle) 
   hdbGetTopCellName(MyHdbHandle) 
   hdbGetTopViewName(MyHdbHandle) )
  MyPathProp = occpGetBestProp(MyOccpHandle MyPathVec "variant")
  when( MyPathProp
   printf("I42 variant is %L\n" MyPathProp->value) )
  occpClose(MyOccpHandle) ))

Related Topics

Hierarchy Database Functions

Occurrence Property Functions

Parent/Child Database Functions

Return to top