Write topological relation data

saf_write_topo_relation is a function defined in rel.c.

Synopsis:

int saf_write_topo_relation(SAF_ParMode pmode, SAF_Rel *rel, hid_t A_type, void *A_buf, hid_t B_type, void *B_buf, SAF_Db *file)

Formal Arguments:

• pmode: The parallel mode.
• rel: The relation handle.
• A_type: See saf_declare_topo_relation.
• A_buf: See saf_declare_topo_relation.
• B_type: See saf_declare_topo_relation.
• B_buf: See saf_declare_topo_relation.
• file: The optional destination file. By default (if null) the data is written to the same file to which rel belongs.

Description: This function writes topological relation data to the given file.

Preconditions:

• pmode must be valid. (low-cost)
• rel must be a valid rel handle. (low-cost)
• A_type must be supplied if A_buf is supplied. (low-cost)
• A- and B-buffers and types must be set appropriately. (high-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.

Parallel Notes: SAF_EACH mode is a collective call where each of the N tasks provides a unique relation. SAF will create a single HDF5 dataset to hold all the data and will create N blobs to point into nonoverlapping regions in that dataset.

See Also:

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