Query dataset bound to a blob

ss_blob_bound_f1 is a function defined in ssblob.c.

Synopsis:

herr_t ss_blob_bound_f1(ss_blob_t *blob, hid_t *dset, hsize_t *offset, hsize_t *size, hid_t *ftype)

Formal Arguments:

  • blob: Blob to query.
  • dset [OUT]: Optional returned dataset handle. The handle is not duplicated and the
  • offset [OUT]: Optional starting offset for the data owned by blob.
  • size [OUT]: Optional number of elements owned by blob.
  • ftype [OUT]: Optional datatype of the underlying dataset. The caller should close this

Description: This is a convenience function for ss_blob_bound_f when the blob data is scalar or one dimensional and contiguous in the dataset. Unlike ss_blob_bound_f, a scalar blob will be treated as a one-dimensional blob of size one in order that offset and size are always returned.

Return Value: Returns non-negative on success; negative on failure. It is considered a failure to make this query when no dataset is bound to the blob or the blob’s region of the dataset doesn’t satisfy the constraints set out above.

Parallel Notes: Independent

See Also:

  • ss_blob_bound_f: 15.8: Query dataset bound to a blob
  • I/O: Introduction for current chapter