Package net.algart.arrays

Class AbstractObjectArray<E>

java.lang.Object

net.algart.arrays.AbstractArray

net.algart.arrays.AbstractObjectArray<E>

All Implemented Interfaces:

Cloneable, Array, ObjectArray<E>

Direct Known Subclasses:

AbstractUpdatableObjectArray

public abstract class AbstractObjectArray<E>
extends AbstractArray
implements ObjectArray<E>

Implementation of almost all basic functions of ObjectArray interface. The only ObjectArray.get(long) method is not defined in this class; all other methods are implemented via calls of ObjectArray.get(long).

Author:

Daniel Alievsky

Field Summary

Fields inherited from class net.algart.arrays.AbstractArray

capacity, length, underlyingArrays

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractObjectArray(Class<E> elementType, long initialCapacityAndLength, boolean underlyingArraysAreParallel, Array... underlyingArrays)	Equivalent to the constructor AbstractObjectArray(Class, long, long, boolean, Array...), where both initialCapacity and initialLength arguments are equal to initialCapacityAndLength.
protected	AbstractObjectArray(Class<E> elementType, long initialCapacity, long initialLength, boolean underlyingArraysAreParallel, Array... underlyingArrays)	Creates an array with the given initial capacity and length.

Method Summary

Modifier and Type	Method	Description
Array	asCopyOnNextWrite()	This implementation returns this object.
ObjectArray<E>	asImmutable()	This implementation returns this object.
ObjectArray<E>	asTrustedImmutable()	This implementation calls asImmutable() and returns its result.
DataObjectBuffer<E>	buffer()	This implementation returns buffer(suitableMode), where suitableMode is this instanceof UpdatableArray ? DataBuffer.AccessMode.READ_WRITE : DataBuffer.AccessMode.READ.
DataObjectBuffer<E>	buffer(long capacity)	This implementation returns buffer(suitableMode, capacity), where capacity is the argument of this method and suitableMode is this instanceof UpdatableArray ? DataBuffer.AccessMode.READ_WRITE : DataBuffer.AccessMode.READ.
DataObjectBuffer<E>	buffer(DataBuffer.AccessMode mode)	This implementation returns buffer(mode, someCapacity), where mode is the argument of this method and someCapacity is the result of defaultBufferCapacity(thisArray) method.
DataObjectBuffer<E>	buffer(DataBuffer.AccessMode mode, long capacity)	This method is fully implemented in this class.
<D> ObjectArray<D>	cast(Class<D> elementType)	Returns this array cast to the specified generic element type or throws ClassCastException if the elements cannot be cast to the required type (because the element type is not its subclass).
void	checkUnallowedMutation()	This implementation does nothing.
Class<E>	elementType()	Returns the type of array elements.
void	flushResources(ArrayContext context, boolean forcePhysicalWriting)	This implementation calls flushResources(context, 0, length(), forcePhysicalWriting).
protected void	flushResources(ArrayContext context, long fromIndex, long toIndex, boolean forcePhysicalWriting)	This method implements all actions that should be performed by subArray(fromIndex, toIndex).flushResources(context, forcePhysicalWriting) call.
void	freeResources(ArrayContext context, boolean forcePhysicalWriting)	This implementation calls freeResources(context, 0, length()), forcePhysicalWriting).
protected void	freeResources(ArrayContext context, long fromIndex, long toIndex, boolean forcePhysicalWriting)	This method implements all actions that should be performed by subArray(fromIndex, toIndex).freeResources(context, forcePhysicalWriting) call.
abstract E	get(long index)	Equivalent to getElement(index).
void	getData(long arrayPos, Object destArray)	This implementation calls getData(long, Object, int, int) with corresponding arguments.
void	getData(long arrayPos, Object destArray, int destArrayOffset, int count)	This implementation is based on a loop of calls of get(long) method.
Object	getElement(long index)	This implementation returns get(index).
long	indexOf(long lowIndex, long highIndex, E value)	This implementation is based on a loop of calls of get(long) method from index max(lowIndex,0) until index min(AbstractArray.length(),highIndex)-1.
boolean	isCopyOnNextWrite()	This implementation returns false.
boolean	isImmutable()	This implementation returns true.
boolean	isUnresizable()	This implementation returns true.
E[]	ja()	This implementation performs the following code:
long	lastIndexOf(long lowIndex, long highIndex, E value)	This implementation is based on a loop of calls of get(long) method from index min(AbstractArray.length(),highIndex)-1 back until index max(lowIndex,0).
void	loadResources(ArrayContext context)	This implementation calls loadResources(context, 0, length()).
protected void	loadResources(ArrayContext context, long fromIndex, long toIndex)	This method implements all actions that should be performed by subArray(fromIndex, toIndex).loadResources(context) call.
MutableObjectArray<E>	mutableClone(MemoryModel memoryModel)	This implementation performs the following: memoryModel.newArray(thisArray).copy(thisArray).
Class<? extends MutableObjectArray<E>>	mutableType()	Returns the canonical resizable AlgART type of arrays with the same element types: the class of one of 9 basic interfaces, describing all kinds of resizable AlgART arrays for 8 primitive and any non-primitive element types.
Array	subArray(long fromIndex, long toIndex)	This implementation returns new instance of AbstractObjectArray with the same memory model and underlying arrays, that were passed to the constructor of this instance, and with overridden methods get(long) and getData(long arrayPos, Object destArray, int destArrayOffset, int count), calling the same methods of this instance with corresponding corrections of the arguments.
String	toString()	Returns a brief string description of this object.
Class<? extends ObjectArray<E>>	type()	Returns the canonical AlgART type of this array: the class of one of 9 basic interfaces, describing all kinds of AlgART arrays for 8 primitive and any non-primitive element types.
UpdatableObjectArray<E>	updatableClone(MemoryModel memoryModel)	This implementation performs the following: memoryModel.newUnresizableArray(thisArray).copy(thisArray).
Class<? extends UpdatableObjectArray<E>>	updatableType()	Returns the canonical updatable AlgART type of arrays with the same element types: the class of one of 9 basic interfaces, describing all kinds of updatable AlgART arrays for 8 primitive and any non-primitive element types.

Methods inherited from class net.algart.arrays.AbstractArray

byteOrder, capacity, checkCopyArguments, checkSubArrArguments, checkSubArrayArguments, checkSwapArguments, defaultAppend, defaultBuffer, defaultBufferCapacity, defaultCopy, defaultCopy, defaultSwap, equals, equals, flushResources, freeResources, hashCode, hashCode, isLazy, isNew, isNewReadOnlyView, isZeroFilled, length, newJavaArray, setNewReadOnlyViewStatus, setNewStatus, shallowClone, standardObjectClone, subArr

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface net.algart.arrays.Array

byteOrder, capacity, equals, flushResources, freeResources, hashCode, isEmpty, isLazy, isNew, isNewReadOnlyView, length, length32, newJavaArray, shallowClone, subArr

Methods inherited from interface net.algart.arrays.ObjectArray

matrix

Constructor Details

AbstractObjectArray

protected AbstractObjectArray(Class<E> elementType,
 long initialCapacity,
 long initialLength,
 boolean underlyingArraysAreParallel,
 Array... underlyingArrays)

Creates an array with the given initial capacity and length.

The underlyingArraysAreParallel informs whether the passed underlying arrays (if they exist) are "parallel" to this one and to each other. Intuitively, it means that every element #k of this array is connected (for example, depends on) the elements #k (of, maybe, #k±i, where i is little) of the underlying arrays. Precisely, this argument affects the following in this implementation:

1. If it is true, then all passed underlying arrays (if underlyingArrays.length>1) must have identical length — in other case, this constructor throws SizeMismatchException.
2. If it is true, then
   • loadResources(ArrayContext context, long fromIndex, long toIndex),
   • flushResources(ArrayContext context, long fromIndex, long toIndex, boolean forcePhysicalWriting) and
   • freeResources(ArrayContext context, long fromIndex, long toIndex, boolean forcePhysicalWriting)
   methods call loadResources(ArrayContext context), flushResources(ArrayContext context, boolean forcePhysicalWriting) and freeResources(ArrayContext context, boolean forcePhysicalWriting) methods for the corresponding subarrays of all underlying arrays. If this argument is false, then
   • loadResources(ArrayContext context, long fromIndex, long toIndex) does nothing,
   • flushResources(ArrayContext context, long fromIndex, long toIndex, boolean forcePhysicalWriting) and freeResources(ArrayContext context, long fromIndex, long toIndex, boolean forcePhysicalWriting) methods ignore their fromIndex / toIndex arguments and call loadResources(ArrayContext context), flushResources(ArrayContext context, boolean forcePhysicalWriting) and freeResources(ArrayContext context, boolean forcePhysicalWriting) methods for original underlying arrays (not their subarrays).
   Of course, if you specify underlyingArraysAreParallel=false, you can override loadResources(ArrayContext context, long fromIndex, long toIndex), flushResources(ArrayContext context, long fromIndex, long toIndex, boolean forcePhysicalWriting) and freeResources(ArrayContext context, long fromIndex, long toIndex, boolean forcePhysicalWriting) methods and offer better implementations for subarrays, for example, that will work with suitable regions of the underlying arrays.

This array is not new by default. This is correct usually, because this class is often used for creating a view of another data. However, if the instance if this class does not depend on any other data sources, you may call setNewStatus(true) in the constructor of your subclass.

The created array never has new-read-only-view status: Array.isNewReadOnlyView() method always returns false in this class and its inheritors.

Parameters:

elementType - the element type of this array.

initialCapacity - initial capacity of the array.

initialLength - initial length of the array.

underlyingArraysAreParallel - whether the underlying arrays are "parallel" to this.

underlyingArrays - see the same argument of AbstractArray(long, long, Array...).

Throws:

NullPointerException - if underlyingArrays argument or some of underlyingArrays[k] elements is null.

IllegalArgumentException - if the initialCapacity or initialLength arguments are illegal (negative, or capacity < length).

SizeMismatchException - if underlyingArraysAreParallel=true, underlyingArrays.length>1 and some of passed arrays have different lengths.

AbstractObjectArray

protected AbstractObjectArray(Class<E> elementType,
 long initialCapacityAndLength,
 boolean underlyingArraysAreParallel,
 Array... underlyingArrays)

Equivalent to the constructor AbstractObjectArray(Class, long, long, boolean, Array...), where both initialCapacity and initialLength arguments are equal to initialCapacityAndLength.

Parameters:

elementType - the element type of this array.

initialCapacityAndLength - initial capacity and length of the array.

underlyingArraysAreParallel - see AbstractObjectArray(Class, long, long, boolean, Array...).

underlyingArrays - see AbstractObjectArray(Class, long, long, boolean, Array...).

Throws:

NullPointerException - if underlyingArrays argument or some of underlyingArrays[k] elements is null.

IllegalArgumentException - if initialCapacityAndLength argument is negative.

SizeMismatchException - if underlyingArraysAreParallel=true, underlyingArrays.length>1 and some of passed arrays have different lengths.

Method Details

elementType

public Class<E> elementType()

Description copied from interface: Array

Returns the type of array elements. For arrays of primitive types, returns:

• boolean.class for BitArray,
• char.class for CharArray,
• byte.class for ByteArray,
• short.class for ShortArray,
• int.class for IntArray),
• long.class for LongArray,
• float.class for FloatArray,
• double.class for DoubleArray.

All elements of the array are values of this type or (for non-primitive types) some inheritor of this type.

There is a guarantee that this method works very quickly (usually it just returns a value of some private field).

Specified by:

elementType in interface Array

Specified by:

elementType in interface ObjectArray<E>

Specified by:

elementType in class AbstractArray

Returns:

the type of array elements.

See Also:

• Arrays.elementType(Class)

type

public Class<? extends ObjectArray<E>> type()

Description copied from interface: Array

Returns the canonical AlgART type of this array: the class of one of 9 basic interfaces, describing all kinds of AlgART arrays for 8 primitive and any non-primitive element types. More precisely, returns:

• BitArray.class, if this object is an instance of BitArray,
• CharArray.class, if this object is an instance of CharArray,
• ByteArray.class, if this object is an instance of ByteArray,
• ShortArray.class, if this object is an instance of ShortArray,
• IntArray.class, if this object is an instance of IntArray,
• LongArray.class, if this object is an instance of LongArray,
• FloatArray.class, if this object is an instance of FloatArray,
• DoubleArray.class, if this object is an instance of DoubleArray,
• ObjectArray.class, if this object is an instance of ObjectArray.

There is a guarantee that this method works very quickly (usually it just returns a constant value).

Specified by:

type in interface Array

Specified by:

type in interface ObjectArray<E>

Specified by:

type in class AbstractArray

Returns:

canonical AlgART type of this array.

updatableType

public Class<? extends UpdatableObjectArray<E>> updatableType()

Description copied from interface: Array

Returns the canonical updatable AlgART type of arrays with the same element types: the class of one of 9 basic interfaces, describing all kinds of updatable AlgART arrays for 8 primitive and any non-primitive element types. More precisely, returns:

• UpdatableBitArray.class, if this object is an instance of BitArray,
• UpdatableCharArray.class, if this object is an instance of CharArray,
• UpdatableByteArray.class, if this object is an instance of ByteArray,
• UpdatableShortArray.class, if this object is an instance of ShortArray,
• UpdatableIntArray.class, if this object is an instance of IntArray,
• UpdatableLongArray.class, if this object is an instance of LongArray,
• UpdatableFloatArray.class, if this object is an instance of FloatArray,
• UpdatableDoubleArray.class, if this object is an instance of DoubleArray,
• UpdatableObjectArray.class, if this object is an instance of ObjectArray.

There is a guarantee that this method works very quickly (usually it just returns a constant value).

Specified by:

updatableType in interface Array

Specified by:

updatableType in interface ObjectArray<E>

Specified by:

updatableType in class AbstractArray

Returns:

canonical AlgART type of an updatable array of the same kind.

mutableType

public Class<? extends MutableObjectArray<E>> mutableType()

Description copied from interface: Array

Returns the canonical resizable AlgART type of arrays with the same element types: the class of one of 9 basic interfaces, describing all kinds of resizable AlgART arrays for 8 primitive and any non-primitive element types. More precisely, returns:

• MutableBitArray.class, if this object is an instance of BitArray,
• MutableCharArray.class, if this object is an instance of CharArray,
• MutableByteArray.class, if this object is an instance of ByteArray,
• MutableShortArray.class, if this object is an instance of ShortArray,
• MutableIntArray.class, if this object is an instance of IntArray,
• MutableLongArray.class, if this object is an instance of LongArray,
• MutableFloatArray.class, if this object is an instance of FloatArray,
• MutableDoubleArray.class, if this object is an instance of DoubleArray,
• MutableObjectArray.class, if this object is an instance of ObjectArray.

There is a guarantee that this method works very quickly (usually it just returns a constant value).

Specified by:

mutableType in interface Array

Specified by:

mutableType in interface ObjectArray<E>

Specified by:

mutableType in class AbstractArray

Returns:

canonical AlgART type of a resizable array of the same kind.

getData

public void getData(long arrayPos,
 Object destArray,
 int destArrayOffset,
 int count)

This implementation is based on a loop of calls of get(long) method. Please override this method if it's possible to perform the same task more efficiently than such a loop.

Specified by:

getData in interface Array

Specified by:

getData in class AbstractArray

Parameters:

arrayPos - starting position in this AlgART array.

destArray - the target Java array.

destArrayOffset - starting position in the target Java array.

count - the number of elements to be copied.

Throws:

NullPointerException - if destArray argument is null.

IllegalArgumentException - if destArray argument is not an array.

IndexOutOfBoundsException - if copying would cause access of data outside this array or target array.

ArrayStoreException - if destArray element type mismatches with this array elementType().

ClassCastException - if destArray element type mismatches with this array elementType() (both this and ArrayStoreException are possible, depending on implementation).

See Also:

• DirectAccessible
• UpdatableArray.setData(long, Object, int, int)
• BitArray.getBits(long, long[], long, long)

getData

public void getData(long arrayPos,
 Object destArray)

This implementation calls getData(long, Object, int, int) with corresponding arguments.

Specified by:

getData in interface Array

Specified by:

getData in class AbstractArray

Parameters:

arrayPos - starting position in this AlgART array.

destArray - the target Java array.

Throws:

NullPointerException - if destArray argument is null.

IllegalArgumentException - if destArray argument is not an array.

IndexOutOfBoundsException - if arrayPos is out of range 0..length()-1.

ArrayStoreException - if destArray element type mismatches with this array elementType().

ClassCastException - if destArray element type mismatches with this array elementType() (both this and ArrayStoreException are possible, depending on implementation).

See Also:

• DirectAccessible
• Array.getData(long, Object, int, int)
• UpdatableArray.setData(long, Object)

getElement

public Object getElement(long index)

This implementation returns get(index).

Specified by:

getElement in interface Array

Specified by:

getElement in class AbstractArray

Parameters:

index - index of element to get.

Returns:

the element at the specified position in this array.

Throws:

IndexOutOfBoundsException - if index is out of range 0..length()-1.

cast

public <D> ObjectArray<D> cast(Class<D> elementType)

Description copied from interface: ObjectArray

Returns this array cast to the specified generic element type or throws ClassCastException if the elements cannot be cast to the required type (because the element type is not its subclass). Equivalent to (ObjectArray)thisArray, but is compiled without "unchecked cast" warning or "inconvertible type" error.

Unlike ArrayList architecture, such casting is safe here, because all methods, storing data in the AlgART array, always check the element type and do not allow saving illegal elements.

Specified by:

cast in interface ObjectArray<E>

Parameters:

elementType - the required generic type.

Returns:

this array cast to the specified generic element type.

subArray

public Array subArray(long fromIndex,
 long toIndex)

This implementation returns new instance of AbstractObjectArray with the same memory model and underlying arrays, that were passed to the constructor of this instance, and with overridden methods get(long) and getData(long arrayPos, Object destArray, int destArrayOffset, int count), calling the same methods of this instance with corresponding corrections of the arguments.

The returned instance also have overridden methods loadResources(ArrayContext, long, long), flushResources(ArrayContext, long, long, boolean) and freeResources(ArrayContext, long, long, boolean), that also call the same methods of this instance with corresponding correction of their fromIndex argument.

The returned instance also have overridden method AbstractArray.isLazy(), that just calls the same methods of this instance with the same arguments.

Specified by:

subArray in interface Array

Specified by:

subArray in class AbstractArray

Parameters:

fromIndex - low endpoint (inclusive) of the subarray.

toIndex - high endpoint (exclusive) of the subarray.

Returns:

a view of the specified range within this array.

Throws:

IndexOutOfBoundsException - for illegal fromIndex and toIndex (fromIndex < 0 || toIndex > length() || fromIndex > toIndex).

See Also:

• Array.subArr(long, long)

buffer

public DataObjectBuffer<E> buffer(DataBuffer.AccessMode mode,
 long capacity)

Description copied from class: AbstractArray

This method is fully implemented in this class.

The returned buffer will be direct, if mode is not PRIVATE, this array is not immutable, is not copy-on-next-write, and either it implements DirectAccessible interface and its hasJavaArray() method returns true, or it is a bit array created by the simple memory model.

Specified by:

buffer in interface Array

Specified by:

buffer in interface ObjectArray<E>

Overrides:

buffer in class AbstractArray

Parameters:

mode - the access mode for new buffer.

capacity - the capacity of the buffer

Returns:

new data buffer for accessing this array.

See Also:

• Array.buffer(net.algart.arrays.DataBuffer.AccessMode)
• Array.buffer(long)
• Array.buffer()

buffer

public DataObjectBuffer<E> buffer(DataBuffer.AccessMode mode)

Description copied from class: AbstractArray

This implementation returns buffer(mode, someCapacity), where mode is the argument of this method and someCapacity is the result of defaultBufferCapacity(thisArray) method.

Specified by:

buffer in interface Array

Specified by:

buffer in interface ObjectArray<E>

Overrides:

buffer in class AbstractArray

Parameters:

mode - the access mode for new buffer.

Returns:

new data buffer for accessing this array.

buffer

public DataObjectBuffer<E> buffer(long capacity)

Description copied from class: AbstractArray

This implementation returns buffer(suitableMode, capacity), where capacity is the argument of this method and suitableMode is this instanceof UpdatableArray ? DataBuffer.AccessMode.READ_WRITE : DataBuffer.AccessMode.READ.

Specified by:

buffer in interface Array

Specified by:

buffer in interface ObjectArray<E>

Overrides:

buffer in class AbstractArray

Parameters:

capacity - the capacity of the buffer.

Returns:

new data buffer for accessing this array.

buffer

public DataObjectBuffer<E> buffer()

Description copied from class: AbstractArray

This implementation returns buffer(suitableMode), where suitableMode is this instanceof UpdatableArray ? DataBuffer.AccessMode.READ_WRITE : DataBuffer.AccessMode.READ.

Specified by:

buffer in interface Array

Specified by:

buffer in interface ObjectArray<E>

Overrides:

buffer in class AbstractArray

Returns:

new data buffer for accessing this array.

get

public abstract E get(long index)

Description copied from interface: ObjectArray

Equivalent to getElement(index).

Specified by:

get in interface ObjectArray<E>

Parameters:

index - index of element to get.

Returns:

the element at the specified position in this array.

indexOf

public long indexOf(long lowIndex,
 long highIndex,
 E value)

This implementation is based on a loop of calls of get(long) method from index max(lowIndex,0) until index min(AbstractArray.length(),highIndex)-1. Please override this method if it's possible to perform the same task more efficiently than such a loop.

Specified by:

indexOf in interface ObjectArray<E>

Parameters:

lowIndex - the low index in the array for search (inclusive).

highIndex - the high index in the array for search (exclusive).

value - the value to be found.

Returns:

the index of the first occurrence of this value in this array in range lowIndex<=index<highIndex, or -1 if this value does not occur in this range.

lastIndexOf

public long lastIndexOf(long lowIndex,
 long highIndex,
 E value)

This implementation is based on a loop of calls of get(long) method from index min(AbstractArray.length(),highIndex)-1 back until index max(lowIndex,0). Please override this method if it's possible to perform the same task more efficiently than such a loop.

Specified by:

lastIndexOf in interface ObjectArray<E>

Parameters:

lowIndex - the low index in the array for search (inclusive).

highIndex - the high index in the array for search (exclusive).

value - the value to be found.

Returns:

the index of the last occurrence of this value in this array in range lowIndex<=index<highIndex, or -1 if this value does not occur in this range.

isImmutable

public boolean isImmutable()

This implementation returns true. Should be overridden if the inheritor is mutable.

Specified by:

isImmutable in interface Array

Specified by:

isImmutable in class AbstractArray

Returns:

true if this instance is immutable.

See Also:

• Array.asImmutable()

isUnresizable

public boolean isUnresizable()

This implementation returns true. Should be overridden if the inheritor is resizable

Specified by:

isUnresizable in interface Array

Specified by:

isUnresizable in class AbstractArray

Returns:

true if this instance is unresizable.

See Also:

• UpdatableArray.asUnresizable()

checkUnallowedMutation

public void checkUnallowedMutation()
                            throws UnallowedMutationError

This implementation does nothing.

Specified by:

checkUnallowedMutation in interface Array

Specified by:

checkUnallowedMutation in class AbstractArray

Throws:

UnallowedMutationError - never in this implementation.

See Also:

• Array.asTrustedImmutable()

asTrustedImmutable

public ObjectArray<E> asTrustedImmutable()

This implementation calls asImmutable() and returns its result.

Specified by:

asTrustedImmutable in interface Array

Specified by:

asTrustedImmutable in interface ObjectArray<E>

Specified by:

asTrustedImmutable in class AbstractArray

Returns:

a trusted immutable view of this array (or a reference to this array if it is already trusted immutable).

See Also:

• Array.asImmutable()
• Array.checkUnallowedMutation()

asCopyOnNextWrite

public Array asCopyOnNextWrite()

This implementation returns this object. Should be overridden if the inheritor is mutable.

Specified by:

asCopyOnNextWrite in interface Array

Specified by:

asCopyOnNextWrite in class AbstractArray

Returns:

a copy-on-next-write view of this array (or a reference to this array if it is immutable or already copy-on-next-write).

See Also:

• Array.isCopyOnNextWrite()
• MemoryModel.newLazyCopy(Array)
• MemoryModel.newUnresizableLazyCopy(Array)

isCopyOnNextWrite

public boolean isCopyOnNextWrite()

This implementation returns false. Should be overridden if the inheritor is mutable.

Specified by:

isCopyOnNextWrite in interface Array

Specified by:

isCopyOnNextWrite in class AbstractArray

Returns:

true if this array is in copy-on-next-write mode

See Also:

• Array.asCopyOnNextWrite()

asImmutable

public ObjectArray<E> asImmutable()

This implementation returns this object. Should be overridden if the inheritor is mutable.

Specified by:

asImmutable in interface Array

Specified by:

asImmutable in interface ObjectArray<E>

Specified by:

asImmutable in class AbstractArray

Returns:

an immutable view of this array (or a reference to this array if it is immutable).

See Also:

• Array.isImmutable()
• Array.asTrustedImmutable()
• Array.mutableClone(MemoryModel)
• Array.updatableClone(MemoryModel)
• UpdatableArray.asUnresizable()

mutableClone

public MutableObjectArray<E> mutableClone(MemoryModel memoryModel)

Description copied from class: AbstractArray

This implementation performs the following: memoryModel.newArray(thisArray).copy(thisArray).

Specified by:

mutableClone in interface Array

Specified by:

mutableClone in interface ObjectArray<E>

Overrides:

mutableClone in class AbstractArray

Parameters:

memoryModel - the memory model, used for allocation a new copy of this array.

Returns:

a mutable copy of this array.

See Also:

• Array.updatableClone(MemoryModel)

updatableClone

public UpdatableObjectArray<E> updatableClone(MemoryModel memoryModel)

Description copied from class: AbstractArray

This implementation performs the following: memoryModel.newUnresizableArray(thisArray).copy(thisArray).

Specified by:

updatableClone in interface Array

Specified by:

updatableClone in interface ObjectArray<E>

Overrides:

updatableClone in class AbstractArray

Parameters:

memoryModel - the memory model, used for allocation a new copy of this array.

Returns:

an updatable copy of this array.

See Also:

• Array.mutableClone(MemoryModel)

ja

public E[] ja()

Description copied from class: AbstractArray

This implementation performs the following code:

     return this instanceof DirectAccessible da &&
                 da.hasJavaArray() &&
                 da.javaArrayOffset() == 0 &&
                 java.lang.reflect.Array.getLength(da.javaArray()) == this.length() ?
                 da.javaArray() :
                 Arrays.toJavaArray(this);
 

Specified by:

ja in interface Array

Specified by:

ja in interface ObjectArray<E>

Overrides:

ja in class AbstractArray

Returns:

Java array, equivalent to this AlgART array.

See Also:

• DirectAccessible
• Arrays.isJavaArrayWrapper(Array)
• PArray.jaByte()
• PArray.jaShort()
• PArray.jaInt()
• PArray.jaLong()
• PArray.jaFloat()
• PArray.jaDouble()

loadResources

public void loadResources(ArrayContext context)

This implementation calls loadResources(context, 0, length()).

Specified by:

loadResources in interface Array

Overrides:

loadResources in class AbstractArray

Parameters:

context - the context of execution; may be null, then it will be ignored.

See Also:

• Array.freeResources(ArrayContext)
• Array.flushResources(ArrayContext)
• Array.flushResources(ArrayContext, boolean)

flushResources

public void flushResources(ArrayContext context,
 boolean forcePhysicalWriting)

This implementation calls flushResources(context, 0, length(), forcePhysicalWriting).

Specified by:

flushResources in interface Array

Overrides:

flushResources in class AbstractArray

Parameters:

context - the context of execution; may be null, then it will be ignored.

forcePhysicalWriting - is it necessary to try forcing physical writing all associated resources to the external device.

See Also:

• Array.loadResources(ArrayContext)
• Array.flushResources(ArrayContext)
• Array.freeResources(ArrayContext, boolean)

freeResources

public void freeResources(ArrayContext context,
 boolean forcePhysicalWriting)

This implementation calls freeResources(context, 0, length()), forcePhysicalWriting).

Specified by:

freeResources in interface Array

Overrides:

freeResources in class AbstractArray

Parameters:

context - the context of execution; may be null, then it will be ignored.

forcePhysicalWriting - is it necessary to try forcing physical writing all associated resources to the external device.

See Also:

• Array.loadResources(ArrayContext context)
• Array.flushResources(ArrayContext context, boolean forcePhysicalWriting)
• Array.freeResources(ArrayContext)
• Arrays.freeAllResources()

loadResources

protected void loadResources(ArrayContext context,
 long fromIndex,
 long toIndex)

This method implements all actions that should be performed by subArray(fromIndex, toIndex).loadResources(context) call. This default implementation calls loadResources(c) (where c is a necessary part of the passed context) for the corresponding subarray of all underlying arrays, passed via the last argument of the constructor, if the underlyingArraysAreParallel constructor argument was true, or does nothing in other case.

Parameters:

context - the context of execution; may be null, then it will be ignored.

fromIndex - low endpoint (inclusive) of the subarray that should be loaded.

toIndex - high endpoint (exclusive) of the subarray that should be loaded.

Throws:

IndexOutOfBoundsException - for illegal fromIndex and toIndex (fromIndex < 0 || toIndex > length() || fromIndex > toIndex).

flushResources

protected void flushResources(ArrayContext context,
 long fromIndex,
 long toIndex,
 boolean forcePhysicalWriting)

This method implements all actions that should be performed by subArray(fromIndex, toIndex).flushResources(context, forcePhysicalWriting) call. This default implementation calls flushResources(c, forcePhysicalWriting) (where c is a necessary part of the passed context) for the corresponding subarray of all underlying arrays, passed via the last argument of the constructor, if the underlyingArraysAreParallel constructor argument was true, or for original underlying arrays in other case (alike AbstractArray.flushResources(ArrayContext, boolean)).

Parameters:

context - the context of execution; may be null, then it will be ignored.

fromIndex - low endpoint (inclusive) of the subarray that should be flushed.

toIndex - high endpoint (exclusive) of the subarray that should be flushed.

forcePhysicalWriting - is it necessary to try forcing physical writing all associated resources to the external device.

Throws:

IndexOutOfBoundsException - for illegal fromIndex and toIndex (fromIndex < 0 || toIndex > length() || fromIndex > toIndex).

freeResources

protected void freeResources(ArrayContext context,
 long fromIndex,
 long toIndex,
 boolean forcePhysicalWriting)

This method implements all actions that should be performed by subArray(fromIndex, toIndex).freeResources(context, forcePhysicalWriting) call. This default implementation calls freeResources(c, forcePhysicalWriting) (where c is a necessary part of the passed context) for the corresponding subarray of all underlying arrays, passed via the last argument of the constructor, if the underlyingArraysAreParallel constructor argument was true, or for original underlying arrays in other case (alike AbstractArray.freeResources(ArrayContext, boolean)).

Parameters:

context - the context of execution; may be null, then it will be ignored.

fromIndex - low endpoint (inclusive) of the subarray that should be freed.

toIndex - high endpoint (exclusive) of the subarray that should be freed.

forcePhysicalWriting - is it necessary to try forcing physical writing all associated resources to the external device.

Throws:

IndexOutOfBoundsException - for illegal fromIndex and toIndex (fromIndex < 0 || toIndex > length() || fromIndex > toIndex).

toString

public String toString()

Description copied from interface: Array

Returns a brief string description of this object.

The result of this method may depend on implementation and usually contains a short description of the array length, capacity, element type.

Note: for character arrays, unlike CharSequence.toString(), this method works as for all other array types. If you need to convert a character array to a string, containing all characters of the array, you may use Arrays.toString(CharArray) method.

Specified by:

toString in interface Array

Specified by:

toString in class AbstractArray

Returns:

a brief string description of this object.