Quantcast

Documentation Center

  • Trial Software
  • Product Updates

H5R.create

Create reference

Syntax

ref = H5R.create(loc_id,name,ref_type,space_id)

Description

ref = H5R.create(loc_id,name,ref_type,space_id) creates the reference, ref, of the type specified in ref_type, pointing to the object specified by name located at loc_id. The ref_type argument can be either 'H5R_OBJECT', or 'H5R_DATASET_REGION'. The space_id argument should be -1, if ref_type is 'H5R_OBJECT'.

Examples

Create a double-precision dataset and a reference dataset.

fid = H5F.create('myfile.h5');
type1_id = H5T.copy('H5T_NATIVE_DOUBLE');
dims = [10 5];
h5_dims = fliplr(dims);
h5_maxdims = h5_dims;
space1_id = H5S.create_simple(2,h5_dims,h5_maxdims);
dcpl = 'H5P_DEFAULT';
dset1_id = H5D.create(fid,'my_double',type1_id,space1_id,dcpl);
type2_id = 'H5T_STD_REF_OBJ';
space2_id = H5S.create('H5S_SCALAR');
dset2_id = H5D.create(fid,'my_ref',type2_id,space2_id,dcpl);
ref_data = H5R.create(fid,'my_double','H5R_OBJECT',-1);
dxpl = 'H5P_DEFAULT';
H5D.write(dset2_id,'H5ML_DEFAULT','H5S_ALL','H5S_ALL',dxpl,ref_data);
H5D.close(dset1_id);
H5D.close(dset2_id);
H5F.close(fid);

See Also

Was this topic helpful?