Query blob extent

ss_blob_space is a function defined in ssblob.c.

Synopsis:

int ss_blob_space(ss_blob_t *blob, hsize_t *size, hid_t *space)

Formal Arguments:

  • blob: The blob to query
  • size [OUT]: Optional returned size per blob dimension
  • space [OUT]: Optional returned data space for the blob

Description: Since storage for multiple blobs can be aggregated into a single HDF5 dataset, the dimensionality and size of a blob might not match that of the whole dataset. This function returns information about the blob’s extent. The blob dimensionality is implied by the dataset-dimensional offset/count values for the blob: any dimension that has a count==1 is considered to be excluded from the blob’s dimensionality.

Return Value: On success, returns the blob’s dimensionality (zero implies scalar) and the extent through the optional size and space arguments. Returns negative on failure. A null blob (a blob that has no elements) will be returned as a one dimensional space whose size is zero.

Parallel Notes: Independent

Example: .. _SC_ss_blob_space:

1
2
 A blob of size [100,1,100] at offset [0,0,0] in a dataset whose size is [100,200,400] will be considered to
 be a two dimensional blob of size [100,100].

See Also:

  • I/O: Introduction for current chapter