Page tree

The license could not be verified: License Certificate has expired!

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 new empty group 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

H5G_CREATE_ANON(loc_id, gcpl_id, gapl_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 H5Gcreate_anon( hid_t loc_id, hid_t gcpl_id, hid_t gapl_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 h5gcreate_anon_f(loc_id, grp_id, hdferr, gcpl_id, gapl_id)

  IMPLICIT NONE
  INTEGER(HID_T), INTENT(IN) :: loc_id   ! Location identifier
  INTEGER(HID_T), INTENT(OUT) :: grp_id  ! Group identifier 
  INTEGER, INTENT(OUT) :: hdferr         ! Error code
                                         ! 0 on success and -1 on failure
  INTEGER(HID_T), OPTIONAL, INTENT(IN) :: gcpl_id  
                                         ! Property list for group creation
  INTEGER(HID_T), OPTIONAL, INTENT(IN) :: gapl_id  
                                         ! Property list for group access
END SUBROUTINE h5gcreate_anon_f</code></pre>

Hdf rm anchor
AnchorNameparameters

Parameters:
HTML Wrap
classhdf-rm-section
hid_t loc_idIN: Object identifier specifying the file in which the new group is to be created; may be a file, group, dataset, named datatype or attribute
hid_t gcpl_idIN: Group creation property list identifier 
(H5P_DEFAULT for the default property list)
hid_t gapl_id    IN: Group access property list identifier 
(No group access properties have been implemented at this time; use H5P_DEFAULT.)

Hdf rm anchor
AnchorNamedescription

Description:
HTML Wrap
classhdf-rm-section

H5G_CREATE_ANON creates a new empty group in the file specified by loc_id. With default settings, H5G_CREATE_ANON provides similar functionality to that provided by H5G_CREATE, with the differences described below.

The new group’s creation and access properties are specified in gcpl_id and gapl_id, respectively.

H5G_CREATE_ANON returns a new group identifier. This identifier must be linked into the HDF5 file structure with H5O_LINK or it will be deleted from the file when the file is closed.

The differences between this function and H5G_CREATE1 are as follows:

  • H5G_CREATE1 does not provide for the use of custom property lists; H5G_CREATE1 always uses default properties.
  • H5G_CREATE_ANON neither provides the new group’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.
  • H5G_CREATE_ANON does not directly provide a hint mechanism for the group’s heap size. Comparable information can be included in the group creation property list gcpl_id through a H5P_SET_LOCAL_HEAP_SIZE_HINT call.

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

See Also:
HTML Wrap
classhdf-rm-section
Info

Hdf rm anchor
AnchorNamereturns

Returns:
HTML Wrap
classhdf-rm-section

Returns a new group identifier if successful; otherwise returns a negative value.

Hdf rm anchor
AnchorNameexample

Example:
HTML Wrap
classhdf-togglebox hdf-c
gcpl = H5Pcreate(H5P_GROUP_CREATE);
...
/* Create the group anonymously and link it in */ grp = H5Gcreate_anon(fid, gcpl, H5P_DEFAULT);
HTML Wrap
classhdf-togglebox hdf-fortran hdf-togglebox-hidden
!  Create a group with no name
  CALL H5Gcreate_anon_f(file_id, group_id, error)

Hdf rm anchor
AnchorNamehistory

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