Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Sometimes it is desired to obtain consistent results from floating point operations, across different JVMs and platforms. This guarantee is imposed by the strictfp modifier. On the downside, it is more likely that intermediate operations will overflow or underflow when strictfp is used because the platform specific floating point behavior is disregarded. These issues are This issue is unavoidable when portability is the main concern. The strictfp modifier can be used with a class, method or interface.

Usage

Strictness Behavior

Class

All code in the class including (instance, variable, static initializers) initializers, code in nested classes

Method

All code within the method is subject to strictness constraints

Interface

All code in the class that implements the interface is also strict

An expression is strict if any of the contained containing classes, methods and or interfaces is defined declared to be a strictfp. Constant expressions containing floating point operations are also evaluated strictly. All compile-time constant expressions are by default, strictfp.

Notably, the strict behavior cannot be inherited by a subclass that extends a strictfp superclass. An overriding method may independently choose to be strictfp when the overridden method is not or vice versa.

Noncompliant Code Example

This noncompliant code example does not enforce the strictfp constraints. Double.MAX_VALUE is being multiplied by 1.1 and reduced back by dividing by 1.1 according to the evaluation order. JVM implementations are not required to report an overflow resulting from the initial multiplication, although they can chose may choose to treat this case as strictfp. The ability to use extended exponent ranges to represent intermediate values is as a result implementation defined.

Code Block
bgColor#FFcccc
class Strictfp {
  public static void main(String[] args) {
    double d = Double.MAX_VALUE;
    System.out.println("This value \"" + ((d * 1.1) / 1.1) + "\" cannot be represented as double.");
  }
}

...

To be compliant, use the strictfp modifier within an expression (class, method or interface) to guarantee that intermediate results do not vary due to because of implementation defined compiler optimizations or by design. This code snippet is guaranteed to return positive INFINITY due to because of the intermediate overflow condition.

...