- Generated by
1.8.18
|
Javolution 6.0.0 java
|
Public Member Functions | |
| T | value () |
An immutable object which can be manipulated by value; a JVM implementation may allocate instances of this class on the stack.
ValueType extends Immutable with the additional constraint that its value is itself (the value method returns
). [code] public final class Complex implements ValueType<Complex> { // Complex is immutable. public class Variable implements Immutable<Complex> { // Variable has immutable value. private Variable() {} // Do not provide access outside. public Variable add(Complex that) { real += that.real; imaginary += that.imaginary; return this; } @Override public Complex value() { return new Complex(real, imaginary); } } private double real, imaginary; public Complex(double real, double imaginary) { this.real = real; this.imaginary = imaginary; } public Complex plus(Complex that) { return new Complex(this.real + that.real, this.imaginary + this.imaginary); } @Override public Complex value() { return this; } // As per ValueType contract. public Variable newVariable() { return new Complex(real, imaginary).new Variable(); } } // Calculates the sum of an array of complex values. Complex[] values = ...;
// Standard calculations (stresses GC due to the high number of objects allocated). Complex sum = Complex.ZERO; for (Complex c : values) sum = sum.plus(c);
// Using variables, 2-3x faster and almost no garbage generated ! Complex.Variable sum = Complex.ZERO.newVariable(); for (Complex c : values) sum.add(c); [/code]
Note: "Stack" allocation is not the only optimization that a VM can do on ValueType. The VM might decide not to perform any allocation at all and store values directly in registers.
| <T> | The type of the immutable constant value. |
Definition at line 63 of file ValueType.java.
| T javolution.lang.ValueType< T >.value | ( | ) |
Returns
.
Implements javolution.lang.Immutable< T >.
Implemented in javolution.text.Text, and javolution.util.Index.
1.8.18