Query dataset bound to a blob

ss_blob_bound_f is a function defined in ssblob.c.

Synopsis:

int ss_blob_bound_f(ss_blob_t *blob, hid_t *dset, hsize_t *offsets, hsize_t *sizes, hid_t *fspace, hid_t *ftype)

Formal Arguments:

  • blob: Blob to query.
  • dset [OUT]: Optional returned dataset handle. The handle is not duplicated and the
  • offsets [OUT]: Optional offset per dataset dimension for the starting position of the
  • sizes [OUT]: Optional size per dataset dimension for the portion of data owned by this
  • fspace [OUT]: Optional data space to be returned. This is the data space of the
  • ftype [OUT]: Optional file datatype to be returned. The caller should close this

Description: A blob can be bound to (part of) a dataset and a call to this function will return the dataset and description of elements to which it is bound.

Return Value: On success, returns the dimensionality of the blob’s dataset. The returned value indicates the number of elements of the optional offsets and sizes arrays that were initialized. A return value of zero indicates a scalar dataset. On failure, a negative value is returned.

Parallel Notes: Independent

See Also:

  • I/O: Introduction for current chapter