Last modified: 19 August 2010
Name: H5Tset_precision
Signature:
  herr_t `H5Tset_precision`( hid_t `dtype_id`, size_t`precision` )

Purpose:
  Sets the precision of an atomic datatype.

Description:
  `H5Tset_precision` sets the precision of an atomic datatype. The precision is the number of significant bits which, unless padding is present, is 8 times larger than the value returned by `H5Tget_size`.

  If the precision is increased then the offset is decreased and then the size is increased to insure that significant bits do not "hang over" the edge of the datatype.

  Changing the precision of an H5T_STRING automatically changes the size as well. The precision must be a multiple of 8.

  When decreasing the precision of a floating point type, set the locations and sizes of the sign, mantissa, and exponent fields first.

Parameters:

  hid_t `dtype_id` | IN: Identifier of datatype to set.
  size_t `precision` | IN: Number of bits of precision for datatype.

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

Fortran90 Interface: h5tset_precision_f

      SUBROUTINE h5tset_precision_f(type_id, precision, hdferr)
        IMPLICIT NONE
        INTEGER(HID_T), INTENT(IN) :: type_id    ! Datatype identifier
        INTEGER(SIZE_T), INTENT(IN) :: precision ! Datatype precision
        INTEGER, INTENT(OUT) :: hdferr           ! Error code
      END SUBROUTINE h5tset_precision_f