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 the range_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 either NOT_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: