Ets_Topo_Assoc_Count_Get()
Abstract
Returns the number of unique objects of the specified type associated with the reference object in the specified direction.
Syntax
Ets_Topo_Assoc_Count_Get (reference_obj_hndl, dir, assoc_mtype)
| Argument | Type | Description |
|---|---|---|
reference_obj_hndl |
EtsT_Obj_Handle |
Handle to reference object. |
dir |
EtsT_Topo_Assoc_Dir |
Value specifying the direction of association (see possible values in Table 42 Topology Package Symbolic Constants). |
assoc_mtype |
“EtsT_Obj_Type“ |
Value specifying the type or meta-type of associated objects (one of the values in Table 33 “General Sub-Package Symbolic Constants“ on page 1046). |
Return Type
int
Number of unique associated objects of specified type in specified direction.
Header
ets_api_topo.h
Details
This function counts the objects associated with the specified reference object (see Associations for a description of how associations are determined).
The assoc_mtype argument can be either a specific object type (such as EtsC_Obj_Type_Node_Fix) or a general object meta-type (such as EtsC_Obj_Mtype_Link).
The function Ets_Topo_Assoc_Get() will return an ETS object handle for each of the counted objects when called with the same reference object, the same direction, the same object type, and an index ranging between zero (inclusive) and the count (exclusive).