Unmounts a file

Procedure:

H5F_UNMOUNT(loc_id, name)

Signature:

<pre><code class="language-c">herr_t H5Funmount(hid_t loc_id, const char *name )</code></pre>

<pre><code class="language-fortran">SUBROUTINE h5funmount_f(loc_id, name, child_id, hdferr)
  IMPLICIT NONE 
  INTEGER(HID_T), INTENT(IN)  :: loc_id      ! File or group identifier
  CHARACTER(LEN=*), INTENT(IN):: name        ! Group name at location loc_id
  INTEGER, INTENT(OUT)        :: hdferr      ! Error code 
                                             ! 0 on success and -1 on failure
END SUBROUTINE h5funmount_f</code></pre>

Parameters:
hid_t loc_idIN: object identifier for the location at which the specified file is to be unmounted; may be a file, group, dataset, named datatype or attribute
const char *name    IN: Name of the mount point

Description:

Given a mount point, H5F_UNMOUNT dissociates the mount point's file from the file mounted there. This function does not close either file.

The mount point can be either the group in the parent or the root group of the mounted file (both groups have the same name). If the mount point was opened before the mount then it is the group in the parent; if it was opened after the mount then it is the root group of the child.

Note that loc_id is either a file or group identifier and name is relative to loc_id.

Returns:

Returns a non-negative value if successful; otherwise returns a negative value.

Example:

Coming soon!