Last modified: 1 May 2013
Name: H5Tenum_valueof
Signature:
  herr_t `H5Tenum_valueof`( hid_t `dtype_id`, char *`name`, void *`value` )

Purpose:
  Returns the value corresponding to a specified member of an enumeration datatype.

Description:
  `H5Tenum_valueof` finds the value that corresponds to the specified `name` of the enumeration datatype `dtype_id`.

  Values returned in `value` will be of the enumerated type’s base type, that is, the datatype used by `H5Tenum_create` when the enumerated type was created.

  The `value` buffer must be at least large enough to hold a value of that base type. If the size is unknown, you can determine it with `H5Tget_size(dtype_id)`, where `dtype_id` is set to the base type.

Parameters:

  hid_t `dtype_id` | IN: Enumeration datatype identifier.
  const char *`name` | IN: Symbol name of the enumeration datatype.
  void *`value` | OUT: Buffer for output of the value of the enumeration datatype.

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

Fortran90 Interface: h5tenum_valueof_f

      SUBROUTINE h5tenum_valueof_f(type_id,  name, value, hdferr)
        IMPLICIT NONE
        INTEGER(HID_T), INTENT(IN) :: type_id ! Datatype identifier
        CHARACTER(LEN=*), INTENT(IN) :: name  ! Name of the enumeration datatype
        INTEGER, INTENT(OUT) :: value         ! Value of the enumeration datatype
        INTEGER, INTENT(OUT) :: hdferr        ! Error code
      END SUBROUTINE h5tenum_valueof_f

See Also:
  `H5Tenum_create`
  `H5Tenum_insert`
  `H5Tenum_nameof`
  `H5Tget_member_value`
  `H5Tconvert`