Get a description of a subset relation¶
saf_describe_subset_relation
is a function defined in rel.c.
Synopsis:
-
int
saf_describe_subset_relation
(SAF_ParMode pmode, SAF_Rel *rel, SAF_Set *sup, SAF_Set *sub, SAF_Cat *sup_cat, SAF_Cat *sub_cat, SAF_BoundMode *sbmode, SAF_BoundMode *cbmode, SAF_RelRep *srtype, hid_t *data_type)¶
Formal Arguments:
pmode
: The parallel mode.rel
: The relation handle.sup
: [OUT
] The superset. PassNULL
if you do not want this value returned.sub
: [OUT
] The subset. PassNULL
if you do not want this value returned.sup_cat
: [OUT
] The collection category on thesup
set upon which the subset relation is defined. Note that collections of this category must have already been defined onsup
. Otherwise, an error is generated. Note that the four argssup_cat
,sub_cat
,sbmode
, andcbmode
are typically passed using one of the macros described in the saf_declare_subset_relation call,SAF__COMMON
,SAF__BOUNDARY
,SAF__EMBEDBND
orSAF__GENERAL
. PassNULL
if you do not want this value returned.sub_cat
: [OUT
] The collection category on thesub
set upon which the subset relation is defined. Again, passNULL
if you do not want this value returned.sbmode
: [OUT
] Indicates whethersub
is the boundary ofsup
. A value ofSAF__BOUNDARY_TRUE
, indicates that thesub
is a boundary ofsup
. A value ofSAF__BOUNDARY_FALSE
indicatessub
is not a boundary ofsup
. PassNULL
if you do not want this value returned.cbmode
: [OUT
] Indicates whether members of collection onsub
are on the boundaries of members of the collection onsup
. A value ofSAF__BOUNDARY_TRUE
indicates they are. A value ofSAF__BOUNDARY_FALSE
indicates they are not. PassNULL
if you do not want this value returned.srtype
: [OUT
] The representation specification. PassNULL
if you do not want this handle returned. See saf_declare_subset_relation for the meaning of values of this argument.data_type
: [OUT
] The data-type of the data stored with the relation. PassNULL
if you do not want this value returned.
Description: Returns information about a subset relation.
Preconditions:
pmode
must be valid. (low-cost)- The
rel
argument must be a valid 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.
See Also:
- saf_declare_subset_relation: 12.5: Declare a subset relation
- Subset Relations: Introduction for current chapter