Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Content Layer
id1195548671
Content Column
width50.00001%
id1195578110
classrm_pagetree_col mobile-hide
Content Block
id1195578111
 
Content Column
width50.00001%
id1195548673
classhdf-rm-main-column
Content Block
id1195548672

Include Content
render-without-blockstrue
page.rm-navbar
HTML Wrap
classhdf-print-only

Page Title

HTML Wrap
classhdf-rm-summary-block

Hdf rm anchor
AnchorNamesummary

Excerpt

Creates a dataset in a file without linking it into the file structure

HTML Wrap
classhdf-rm-content-block

Hdf rm anchor
AnchorNameprocedure

Procedure:
HTML Wrap
classhdf-rm-section
HTML Wrap
classhdf_procedure

H5D_CREATE_ANON(loc_id, type_id, space_id, dcpl_id, dapl_id)

Hdf rm anchor
AnchorNamesignature

Signature:
HTML Wrap
classhdf-rm-section
HTML Wrap
classhdf-togglebox hdf-c

HTML Add Class
hdf-togglebutton-visible
hdf-togglebutton-visible
selector.hdf-togglebutton.hdf-c

HTML
<pre><code class="language-c">hid_t H5Dcreate_anon
(
    hid_t loc_id,
    hid_t type_id,
    hid_t space_id,
    hid_t dcpl_id,
    hid_t dapl_id
)</code></pre>
HTML Wrap
classhdf-togglebox hdf-fortran hdf-togglebox-hidden

HTML Add Class
hdf-togglebutton-visible
hdf-togglebutton-visible
selector.hdf-togglebutton.hdf-fortran

HTML
<pre><code class="language-fortran">SUBROUTINE h5dcreate_anon_f(loc_id, type_id, space_id, dset_id, hdferr, &
                            dcpl_id, dapl_id)
  IMPLICIT NONE
  INTEGER(HID_T), INTENT(IN)  :: loc_id   ! File or group identifier. 
  INTEGER(HID_T), INTENT(IN)  :: type_id  ! Datatype identifier. 
  INTEGER(HID_T), INTENT(IN)  :: space_id ! Dataspace identifier.
  INTEGER(HID_T), INTENT(OUT) :: dset_id  ! Dataset identifier. 
  INTEGER, INTENT(OUT) :: hdferr          ! Error code.  
                                          ! 0 on success and -1 on failure
  INTEGER(HID_T), OPTIONAL, INTENT(IN) :: dcpl_id  
                                          ! Dataset creation property list 
                                          ! identifier.
  INTEGER(HID_T), OPTIONAL, INTENT(IN) :: dapl_id  
                                          ! Dataset access property list 
                                          ! identifier.
END SUBROUTINE h5dcreate_anon_f</code></pre>

Hdf rm anchor
AnchorNameparameters

Parameters:
HTML Wrap
classhdf-rm-section
hid_t loc_idIN: Location identifier; may be a file, group, dataset, named datatype, or attribute
hid_t type_idIN: Identifier of the datatype to use when creating the dataset
hid_t space_id    IN: Identifier of the dataspace to use when creating the dataset
hid_t dcpl_idIN: Dataset creation property list identifier
hid_t dapl_idIN: Dataset access property list identifier

Hdf rm anchor
AnchorNamedescription

Description:
HTML Wrap
classhdf-rm-section

H5D_CREATE_ANON creates a dataset in the file specified by loc_id.

loc_id may be a file, group, dataset, named datatype or attribute.  If an attribute, dataset, or named datatype is specified for loc_id then the dataset will be created at the location where the attribute, dataset, or named datatype is attached.

The dataset’s datatype and dataspace are specified by type_id and space_id, respectively. These are the datatype and dataspace of the dataset as it will exist in the file, which may differ from the datatype and dataspace in application memory.

Dataset creation properties are specified in the dataset creation property list dcpl_id. Dataset access properties are specified in the dataset access property list dapl_id.

H5D_CREATE_ANON returns a new dataset identifier. Using this identifier, the new dataset must be linked into the HDF5 file structure with H5O_LINK or it will be deleted from the file when the file is closed.

See H5D_CREATE for further details and considerations on the use of H5D_CREATE and H5D_CREATE_ANON.

The differences between this function and H5D_CREATE are as follows:

  • H5D_CREATE_ANON explicitly includes a dataset access property list. H5Dcreate always uses default dataset access properties.
  • H5D_CREATE_ANON neither provides the new dataset’s name nor links it into the HDF5 file structure; those actions must be performed separately through a call to H5O_LINK, which offers greater control over linking.

A dataset created with this function should be closed with H5D_CLOSE when the dataset is no longer needed so that resource leaks will not develop.

Hdf rm anchor
AnchorNamereturns

Returns:
HTML Wrap
classhdf-rm-section

Returns a dataset identifier if successful; otherwise returns a negative value.

Hdf rm anchor
AnchorNameexample

Example:
HTML Wrap
classhdf-rm-section

Coming Soon!

Comment
HTML Wrap
classhdf-togglebox hdf-c

Bitbucket Server file
repoSlughdf5
branchIdrefs/heads/1.10/master
projectKeyHDFFV
filepathexamples/h5_subset.c
showLineNumberstrue
lineStart32
progLangcpp
lineEnd42
applicationLink5ac7b370-7412-3c8c-ad20-807a68261336

HTML Wrap
classhdf-togglebox hdf-fortran hdf-togglebox-hidden

Bitbucket Server file
repoSlughdf5
branchIdrefs/heads/1.10/master
projectKeyHDFFV
filepathfortran/examples/compound.f90
showLineNumberstrue
lineStart25
progLangplain
lineEnd35
applicationLink5ac7b370-7412-3c8c-ad20-807a68261336

Hdf rm anchor
AnchorNameseealso

See Also:
HTML Wrap
classhdf-rm-section

Content by Label
showLabelsfalse
showSpacefalse
excerptTypesimple
cqllabel = "rm_h5o" and title ~ "H5O_LINK"

Content by Label
showLabelsfalse
showSpacefalse
excerptTypesimple
cqllabel = "rm_h5d" and title ~ "H5D_CREATE"

Content by Label
showLabelsfalse
showSpacefalse
excerptTypesimple
cqllabel = "advanced-topic" and title ~ "Using Identifiers"

Hdf rm anchor
AnchorNamehistory

History:
HTML Wrap
classhdf-rm-section
Release    Release    Change
1.8.0Function introduced in this release.