net.algart.arrays

Class FloatJArrayHolder

java.lang.Object

net.algart.arrays.FloatJArrayHolder

public final class FloatJArrayHolder
extends java.lang.Object

A simple class allowing to reuse Java float[] array many times. It can be useful, when the algorithm usually allocates float[] array with the same size many times (changing the size is a rare event). In this case, you can replace "new" operator (that spends time for zero-initialing new array) with quickNew(int) method, that probably will work very quickly. The previously allocated array is stored inside the object in a SoftReference.

This class is thread-safe: you may use the same instance of this class in several threads.

Since:

JDK 1.5

Version:

1.2

Author:

Daniel Alievsky

Constructor Summary

Constructors

Constructor and Description
FloatJArrayHolder()

Method Summary

Modifier and Type	Method and Description
float[]	quickClone(float[] array) Quick analog of array.clone().
float[]	quickNew(int newArrayLength) Quick analog of new float[newArrayLength]}.
float[]	quickNew(long newArrayLength) Equivalent of quickNew(int) method, but in addition it checks that newArrayLength is actually 32-bit value (newArrayLength==(int)newArrayLength) and, if not, throws TooLargeArrayException.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FloatJArrayHolder

public FloatJArrayHolder()

Method Detail

quickNew

public float[] quickNew(long newArrayLength)

Equivalent of quickNew(int) method, but in addition it checks that newArrayLength is actually 32-bit value (newArrayLength==(int)newArrayLength) and, if not, throws TooLargeArrayException.

Parameters:

newArrayLength - required array length.

Returns:

newly created "new float[newArrayLength]" or previously allocated array, if it exists and has identical length.

Throws:

java.lang.IllegalArgumentException - if newArrayLength < 0.

TooLargeArrayException - if newArrayLength > Integer.MAX_VALUE.

quickNew

public float[] quickNew(int newArrayLength)

Quick analog of new float[newArrayLength]}. If this method is called several times for allocating data with the same size, this method returns previously allocated array. (Previous array is stored in SoftReference and, if there is not enough memory, can be utilized by garbage collector; in this case, this method will just use "new" operator.)

Please remember: unlike standard new operator, the returned array is usually not filled by zeros.

Parameters:

newArrayLength - required array length.

Returns:

newly created "new float[newArrayLength]" or previously allocated array, if it exists and has identical length.

Throws:

java.lang.IllegalArgumentException - if newArrayLength < 0

quickClone

public float[] quickClone(float[] array)

Quick analog of array.clone(). Equivalent to the following operators:

     float[] result = quickNew(int) quickNew}(array.length);
     System.arraycopy(array, 0, result, 0, array.length);
     (return result)
 

Parameters:

array - some array to clone.

Returns:

exact copy of the source array.

Throws:

java.lang.NullPointerException - if the passed array is null.