Set the destination form of a topological relation¶
saf_target_topo_relation
is a function defined in rel.c.
Synopsis:
-
int
saf_target_topo_relation
(SAF_RelTarget *target, SAF_Set *range_set, SAF_Cat *range_cat, SAF_Cat *decomp, SAF_RelRep *trtype, hid_t data_type)¶
Formal Arguments:
target
: [OUT
] Relation targeting information to be initialized by this function.range_set
: Optional set.range_cat
: Together therange_set
this identifies the target collection to be used to glue the pieces together. Currently both of these parameters are ignored.decomp
: The optional target decomposition.trtype
: The optional target relation types. Currently this parameter is ignored.data_type
: The optional target data type.
Description: This function establishes the target (destination) form of topo relation data during either read or write. When used prior to a write call, it establishes the form of data in the file. When used prior to a read call, it establishes the form of data as desired in memory.
Preconditions:
- Must pass non-null target information. (low-cost)
decomp
must be eitherNOT_SET
,SELF_DECOMP
or a valid cat handle. (low-cost)
Return Value: The constant SAF__SUCCESS
is returned when this function is successful. Otherwise this function either returns
an error number or throws an exception, depending on the value of the library’s error handling property.
Issues: Not all features have been implemented yet.
See Also:
- Topology Relations: Introduction for current chapter