Clicky

Fortran Wiki
selected_real_kind

Description

selected_real_kind(p, r, radix) return the kind value of a real data type with decimal precision of at least p digits, exponent range of at least r, and with a radix of radix.

Standard

Fortran 95 and later; with radix Fortran 2008 and later

Class

Transformational function

Syntax

result = selected_real_kind([p, r, radix])

Arguments

  • p - (Optional) shall be a scalar and of type integer.
  • r - (Optional) shall be a scalar and of type integer.
  • radix - (Optional) shall be a scalar and of type integer.

Before Fortran 2008, at least one of the arguments r or p shall be present; since Fortran 2008, they are assumed to be zero if absent.

Return value

selected_real_kind returns the value of the kind type parameter of a real data type with decimal precision of at least p digits, a decimal exponent range of at least r, and with the requested radix. If the radix parameter is absent, real kinds with any radix can be returned. If more than one real data type meet the criteria, the kind of the data type with the smallest decimal precision is returned. If no real data type matches the criteria, the result is

  • -1 if the processor does not support a real data type with a precision greater than or equal to p, but the r and radix requirements can be fulfilled
  • -2 if the processor does not support a real type with an exponent range greater than or equal to r, but p and radix are fulfillable
  • -3 if radix but not p and r requirements are fulfillable
  • -4 if radix and either p or r requirements are fulfillable
  • -5 if there is no real type with the given radix

Example

program real_kinds
  integer,parameter :: p6 = selected_real_kind(6)
  integer,parameter :: p10r100 = selected_real_kind(10,100)
  integer,parameter :: r400 = selected_real_kind(r=400)
  real(kind=p6) :: x
  real(kind=p10r100) :: y
  real(kind=r400) :: z

  print *, precision(x), range(x)
  print *, precision(y), range(y)
  print *, precision(z), range(z)
end program real_kinds

See also

precision, range, radix

category: intrinsics