Read topological relation data

saf_read_topo_relation is a function defined in rel.c.

Synopsis:

int saf_read_topo_relation(SAF_ParMode pmode, SAF_Rel *rel, SAF_RelTarget *target, void **abuf, void **bbuf)

Formal Arguments:

• pmode: The parallel mode.
• rel: The topology relation to be read.
• target: Relation targeting information.
• abuf: The returned data. See saf_declare_topo_relation.
• bbuf: The returned data. See saf_declare_topo_relation.

Description: This function reads topological relation data from the database.

Preconditions:

• pmode must be valid. (low-cost)
• rel must be a valid relation handle. (low-cost)
• abuf must be non-null. (low-cost)
• Either both abuf and bbuf point to NULL or both abuf and bbuf do not point to NULL. (low-cost)
• If targeting of storage decomposition is used, the read must be a SAF__ALL mode read. (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.

See Also:

• saf_declare_topo_relation: 13.1: Declare a topological relation
• Topology Relations: Introduction for current chapter