Package net.algart.arrays

Class AbstractUpdatableBitArray

java.lang.Object

net.algart.arrays.AbstractArray

net.algart.arrays.AbstractBitArray

net.algart.arrays.AbstractUpdatableBitArray

All Implemented Interfaces:

Cloneable, Array, ArrayExchanger, BitArray, PArray, PFixedArray, UpdatableArray, UpdatableBitArray, UpdatablePArray, UpdatablePFixedArray

public abstract class AbstractUpdatableBitArray
extends AbstractBitArray
implements UpdatableBitArray

Implementation of almost all basic functions of UpdatableBitArray interface. The only BitArray.getBit(long) and UpdatableBitArray.setBit(long, boolean) methods are not defined in this class; all other methods are implemented via calls of these 2 methods.

Author:

Daniel Alievsky

Field Summary

Fields inherited from class net.algart.arrays.AbstractArray

capacity, length, underlyingArrays

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
UpdatableArray	asCopyOnNextWrite()	This implementation returns updatableClone(Arrays.SMM).
BitArray	asImmutable()	This implementation returns an instance of the subclass of AbstractBitArray, where the following method are overridden and call the same methods of this instance: AbstractBitArray.getBit(long), AbstractBitArray.getData(long, Object, int, int), AbstractBitArray.getData(long, Object), AbstractBitArray.loadResources(ArrayContext, long, long), AbstractBitArray.flushResources(ArrayContext, long, long, boolean) and AbstractBitArray.freeResources(ArrayContext, long, long, boolean).
UpdatableBitArray	asUnresizable()	This implementation returns this object.
void	clearBit(long index)	Clears the bit #index to 0 (false).
void	copy(long destIndex, long srcIndex)	This implementation calls setBit(destIndex, getBit(srcIndex)).
void	copy(long destIndex, long srcIndex, long count)	This implementation is based on a loop of calls of copy(long, long) method.
UpdatableArray	copy(Array src)	This implementation calls defaultCopy(thisInstance, src).
final UpdatableBitArray	fill(boolean value)	This implementation just calls fill(0, thisArray.length(), value).
final UpdatableBitArray	fill(double value)	This implementation just calls fill(0, thisArray.length(), value).
final UpdatableBitArray	fill(long value)	This implementation just calls fill(0, thisArray.length(), value).
UpdatableBitArray	fill(long position, long count, boolean value)	This implementation does the following: subArr(position, count).copy(Arrays.nBitCopies(count, value)).
UpdatableBitArray	fill(long position, long count, double value)	This implementation just calls fill(position, count, (boolean)value).
UpdatableBitArray	fill(long position, long count, long value)	This implementation just calls fill(position, count, (boolean)value).
boolean	isImmutable()	This implementation returns false.
void	setBit(long index)	Sets the bit #index to 1 (true).
abstract void	setBit(long index, boolean value)	Sets the element #index to specified value.
UpdatableBitArray	setBits(long arrayPos, long[] srcArray, long srcArrayOffset, long count)	This implementation is based on a loop of calls of setBit(long, boolean) method.
UpdatableArray	setData(long arrayPos, Object srcArray)	This implementation calls setData(long, Object, int, int) with corresponding arguments.
UpdatableArray	setData(long arrayPos, Object srcArray, int srcArrayOffset, int count)	This implementation is based on a loop of calls of setBit(long, boolean) method.
void	setDouble(long index, double value)	Sets the element #index with conversion from double, as (xxx)value for numeric element type xxx (byte, short, int, long, float, double or char), or as value!=0.0 for boolean element type.
void	setElement(long index, Object value)	This implementation calls setBit(index, (Boolean)value).booleanValue()).
void	setInt(long index, int value)	Sets the element #index with conversion from int, as (xxx)value for numeric element type xxx (byte, short, int, long, float, double or char), or as value!=0 for boolean element type.
void	setLong(long index, long value)	Sets the element #index with conversion from long, as (xxx)value for numeric element type xxx (byte, short, int, long, float, double or char), or as value!=0 for boolean element type.
void	setNonNew()	This implementation calls setNewStatus(false).
UpdatableArray	shallowClone()	This implementation returns (UpdatableArray)super.shallowClone().
UpdatableBitArray	subArr(long position, long count)	This implementation returns subArray(position, position + count).
UpdatableBitArray	subArray(long fromIndex, long toIndex)	This implementation returns new instance of AbstractUpdatableBitArray with the same memory model and underlying arrays, that were passed to the constructor of this instance, and with overridden methods AbstractBitArray.getBit(long), setBit(long, boolean), AbstractBitArray.getData(long, Object, int, int) and setData(long, Object, int, int) calling the same methods of this instance with corresponding corrections of the arguments.
void	swap(long firstIndex, long secondIndex)	This implementation swaps two elements by AbstractBitArray.getBit(long) and setBit(long, boolean) methods.
void	swap(long firstIndex, long secondIndex, long count)	This implementation is based on a loop of calls of swap(long, long) method.
UpdatableArray	swap(UpdatableArray another)	This implementation calls defaultSwap(thisInstance, another).
String	toString()	Returns a brief string description of this object.

Methods inherited from class net.algart.arrays.AbstractBitArray

asTrustedImmutable, bitsPerElement, buffer, buffer, buffer, buffer, checkUnallowedMutation, elementType, flushResources, flushResources, freeResources, freeResources, getBit, getBits, getData, getData, getDouble, getElement, getInt, getLong, indexOf, indexOf, indexOf, isCopyOnNextWrite, isUnresizable, ja, lastIndexOf, lastIndexOf, lastIndexOf, loadResources, loadResources, maxPossibleValue, maxPossibleValue, minPossibleValue, minPossibleValue, mutableClone, mutableType, nextQuickPosition, type, updatableClone, updatableType

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, standardObjectClone

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, checkUnallowedMutation, elementType, equals, flushResources, flushResources, freeResources, freeResources, getData, getData, getElement, hashCode, isCopyOnNextWrite, isEmpty, isLazy, isNew, isNewReadOnlyView, isUnresizable, length, length32, loadResources, newJavaArray

Methods inherited from interface net.algart.arrays.BitArray

asTrustedImmutable, buffer, buffer, buffer, buffer, getBit, getBits, getInt, indexOf, ja, lastIndexOf, mutableClone, mutableType, nextQuickPosition, type, updatableClone, updatableType

Methods inherited from interface net.algart.arrays.PArray

bitsPerElement, getDouble, indexOf, isZeroFilled, jaByte, jaDouble, jaFloat, jaInt, jaLong, jaShort, lastIndexOf, maxPossibleValue, minPossibleValue

Methods inherited from interface net.algart.arrays.PFixedArray

getLong, indexOf, lastIndexOf, maxPossibleValue, minPossibleValue

Methods inherited from interface net.algart.arrays.UpdatableBitArray

matrix

Methods inherited from interface net.algart.arrays.UpdatablePArray

updatableType

Constructor Details

AbstractUpdatableBitArray

protected AbstractUpdatableBitArray(long initialCapacity,
 long initialLength,
 boolean underlyingArraysAreParallel,
 Array... underlyingArrays)

Creates an updatable array with the given initial capacity and length.

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.

Parameters:

initialCapacity - initial capacity of the array.

initialLength - initial length of the array.

underlyingArraysAreParallel - see the same argument of AbstractBitArray(long, long, boolean, Array...).

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.

AbstractUpdatableBitArray

protected AbstractUpdatableBitArray(long initialCapacityAndLength,
 boolean underlyingArraysAreParallel,
 Array... underlyingArrays)

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

Parameters:

initialCapacityAndLength - initial capacity and length of the array.

underlyingArraysAreParallel - see AbstractUpdatableBitArray(long, long, boolean, Array...).

underlyingArrays - see AbstractUpdatableBitArray(long, long, boolean, Array...)

Throws:

IllegalArgumentException - if the passed argument are illegal (negative).

Method Details

subArray

public UpdatableBitArray subArray(long fromIndex,
 long toIndex)

This implementation returns new instance of AbstractUpdatableBitArray with the same memory model and underlying arrays, that were passed to the constructor of this instance, and with overridden methods AbstractBitArray.getBit(long), setBit(long, boolean), AbstractBitArray.getData(long, Object, int, int) and setData(long, Object, int, int) calling the same methods of this instance with corresponding corrections of the arguments.

The returned instance also have overridden methods AbstractBitArray.loadResources(ArrayContext, long, long), AbstractBitArray.flushResources(ArrayContext, long, long, boolean) and AbstractBitArray.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 interface UpdatableArray

Specified by:

subArray in interface UpdatableBitArray

Specified by:

subArray in interface UpdatablePArray

Specified by:

subArray in interface UpdatablePFixedArray

Overrides:

subArray in class AbstractBitArray

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)

subArr

public UpdatableBitArray subArr(long position,
 long count)

Description copied from class: AbstractArray

This implementation returns subArray(position, position + count). Please note that the exception message can be not fully correct for the very exotic case position+count>Long.MAX_VALUE.

Specified by:

subArr in interface Array

Specified by:

subArr in interface UpdatableArray

Specified by:

subArr in interface UpdatableBitArray

Specified by:

subArr in interface UpdatablePArray

Specified by:

subArr in interface UpdatablePFixedArray

Overrides:

subArr in class AbstractArray

Parameters:

position - start position (inclusive) of the subarray.

count - number of elements in the subarray.

Returns:

a view of the specified range within this array.

See Also:

• Array.subArray(long, long)

setDouble

public void setDouble(long index,
 double value)

Description copied from interface: UpdatablePArray

Sets the element #index with conversion from double, as (xxx)value for numeric element type xxx (byte, short, int, long, float, double or char), or as value!=0.0 for boolean element type.

Depending on the specific subinterface implemented by the object, this method is equivalent to one of the following calls:

• for UpdatableBitArray: setBit(index, value != 0.0);
• for UpdatableCharArray: setChar(index, (char) value);
• for UpdatableByteArray: setByte(index, (byte) value);
• for UpdatableShortArray: setShort(index, (short) value);
• for UpdatableLongArray: setLong(index, (long) value);
• for UpdatableFloatArray: setFloat(index, (float) value);
• for UpdatableDoubleArray: the same method is already declared in this interface.

Specified by:

setDouble in interface UpdatablePArray

Parameters:

index - index of element to replace.

value - element to be stored at the specified position.

See Also:

• PArray.getDouble(long)

setLong

public void setLong(long index,
 long value)

Description copied from interface: UpdatablePArray

Sets the element #index with conversion from long, as (xxx)value for numeric element type xxx (byte, short, int, long, float, double or char), or as value!=0 for boolean element type.

Depending on the specific subinterface implemented by the object, this method is equivalent to one of the following calls:

• for UpdatableBitArray: setBit(index, value != 0);
• for UpdatableCharArray: setChar(index, (char) value);
• for UpdatableByteArray: setByte(index, (byte) value);
• for UpdatableShortArray: setShort(index, (short) value);
• for UpdatableLongArray: the same method is already declared in this interface;
• for UpdatableFloatArray: setFloat(index, (float) value);
• for UpdatableDoubleArray: setDouble(index, (double) value).

Specified by:

setLong in interface UpdatablePArray

Parameters:

index - index of element to replace.

value - element to be stored at the specified position.

See Also:

• PFixedArray.getLong(long)

setInt

public void setInt(long index,
 int value)

Description copied from interface: UpdatablePArray

Sets the element #index with conversion from int, as (xxx)value for numeric element type xxx (byte, short, int, long, float, double or char), or as value!=0 for boolean element type.

This method is equivalent to both setLong(index, (long) value) and setDouble(index, (double) value), but can work little faster.

Specified by:

setInt in interface UpdatablePArray

Parameters:

index - index of element to replace.

value - element to be stored at the specified position.

See Also:

• PFixedArray.getInt(long)

setBit

public abstract void setBit(long index,
 boolean value)

Description copied from interface: UpdatableBitArray

Sets the element #index to specified value.

Specified by:

setBit in interface UpdatableBitArray

Parameters:

index - index of element to replace.

value - element to be stored at the specified position.

fill

public final UpdatableBitArray fill(double value)

This implementation just calls fill(0, thisArray.length(), value).

Specified by:

fill in interface UpdatablePArray

Parameters:

value - the value to be stored in all elements of the array.

Returns:

a reference to this array.

See Also:

• UpdatablePArray.fill(long, long, double)
• Arrays.zeroFill(UpdatableArray)

fill

public UpdatableBitArray fill(long position,
 long count,
 double value)

This implementation just calls fill(position, count, (boolean)value).

Specified by:

fill in interface UpdatablePArray

Parameters:

position - start index (inclusive) to be filled.

count - number of filled elements.

value - the value to be stored in the elements of the array.

Returns:

a reference to this array.

Throws:

IndexOutOfBoundsException - for illegal position and count (position < 0 || count < 0 || position + count > length()).

See Also:

• UpdatablePArray.fill(double)
• Arrays.zeroFill(UpdatableArray)

fill

public final UpdatableBitArray fill(long value)

This implementation just calls fill(0, thisArray.length(), value).

Specified by:

fill in interface UpdatablePArray

Parameters:

value - the value to be stored in all elements of the array.

Returns:

a reference to this array.

See Also:

• UpdatablePArray.fill(long, long, long)
• Arrays.zeroFill(UpdatableArray)

fill

public UpdatableBitArray fill(long position,
 long count,
 long value)

This implementation just calls fill(position, count, (boolean)value).

Specified by:

fill in interface UpdatablePArray

Parameters:

position - start index (inclusive) to be filled.

count - number of filled elements.

value - the value to be stored in the elements of the array.

Returns:

a reference to this array.

Throws:

IndexOutOfBoundsException - for illegal position and count (position < 0 || count < 0 || position + count > length()).

See Also:

• UpdatablePArray.fill(long)
• Arrays.zeroFill(UpdatableArray)

fill

public final UpdatableBitArray fill(boolean value)

This implementation just calls fill(0, thisArray.length(), value).

Specified by:

fill in interface UpdatableBitArray

Parameters:

value - the value to be stored in all elements of the array.

Returns:

a reference to this array.

See Also:

• UpdatableBitArray.fill(long, long, boolean)
• Arrays.zeroFill(UpdatableArray)

fill

public UpdatableBitArray fill(long position,
 long count,
 boolean value)

This implementation does the following: subArr(position, count).copy(Arrays.nBitCopies(count, value)). Please override this method if it's possible to perform the same task more efficiently.

Specified by:

fill in interface UpdatableBitArray

Parameters:

position - start index (inclusive) to be filled.

count - number of filled elements.

value - the value to be stored in the elements of the array.

Returns:

a reference to this array.

Throws:

IndexOutOfBoundsException - for illegal position and count (position < 0 || count < 0 || position + count > length()).

See Also:

• UpdatableBitArray.fill(boolean)
• Arrays.zeroFill(UpdatableArray)

isImmutable

public boolean isImmutable()

This implementation returns false.

Specified by:

isImmutable in interface Array

Overrides:

isImmutable in class AbstractBitArray

Returns:

true if this instance is immutable.

See Also:

• Array.asImmutable()

asImmutable

public BitArray asImmutable()

This implementation returns an instance of the subclass of AbstractBitArray, where the following method are overridden and call the same methods of this instance: AbstractBitArray.getBit(long), AbstractBitArray.getData(long, Object, int, int), AbstractBitArray.getData(long, Object), AbstractBitArray.loadResources(ArrayContext, long, long), AbstractBitArray.flushResources(ArrayContext, long, long, boolean) and AbstractBitArray.freeResources(ArrayContext, long, long, boolean).

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

Specified by:

asImmutable in interface Array

Specified by:

asImmutable in interface BitArray

Specified by:

asImmutable in interface PArray

Specified by:

asImmutable in interface PFixedArray

Overrides:

asImmutable in class AbstractBitArray

Returns:

an immutable view of this array.

See Also:

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

shallowClone

public UpdatableArray shallowClone()

This implementation returns (UpdatableArray)super.shallowClone().

Specified by:

shallowClone in interface Array

Specified by:

shallowClone in interface UpdatableArray

Overrides:

shallowClone in class AbstractArray

Returns:

a shallow copy of this object.

See Also:

• Array.length()
• Array.capacity()
• DirectAccessible.javaArrayOffset()
• Array.isCopyOnNextWrite()

setElement

public void setElement(long index,
 Object value)

This implementation calls setBit(index, (Boolean)value).booleanValue()).

Specified by:

setElement in interface UpdatableArray

Parameters:

index - index of element to replace.

value - element to be stored at the specified position.

Throws:

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

NullPointerException - if value == null and it is an array of primitive elements

ClassCastException - if it is an array of primitive elements and value is not a corresponding wrapped class (Boolean, Integer, etc.)

ArrayStoreException - if it is an array of non-primitive elements and value is not an instance of AbstractBitArray.elementType() class

setData

public UpdatableArray setData(long arrayPos,
 Object srcArray,
 int srcArrayOffset,
 int count)

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

Specified by:

setData in interface UpdatableArray

Parameters:

arrayPos - starting position in this AlgART array.

srcArray - the source Java array.

srcArrayOffset - starting position in the source Java array.

count - the number of elements to be copied.

Returns:

a reference to this AlgART array.

Throws:

NullPointerException - if srcArray argument is null.

IllegalArgumentException - if srcArray argument is not an array.

IndexOutOfBoundsException - if copying would cause access of data outside this array or source Java 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
• Array.getData(long, Object, int, int)

setData

public UpdatableArray setData(long arrayPos,
 Object srcArray)

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

Specified by:

setData in interface UpdatableArray

Parameters:

arrayPos - starting position in this AlgART array.

srcArray - the source Java array.

Returns:

a reference to this AlgART array.

Throws:

NullPointerException - if srcArray argument is null.

IllegalArgumentException - if srcArray argument is not an array.

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

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

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

See Also:

• DirectAccessible
• UpdatableArray.setData(long, Object, int, int)
• Array.getData(long, Object)
• UpdatableBitArray.setBits(long, long[], long, long)

copy

public void copy(long destIndex,
 long srcIndex)

This implementation calls setBit(destIndex, getBit(srcIndex)).

Specified by:

copy in interface UpdatableArray

Parameters:

destIndex - index of element to replace.

srcIndex - index of element to be copied.

Throws:

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

copy

public void copy(long destIndex,
 long srcIndex,
 long count)

This implementation is based on a loop of calls of copy(long, long) method.

Specified by:

copy in interface UpdatableArray

Parameters:

destIndex - starting index of element to replace.

srcIndex - starting index of element to be copied.

count - the number of elements to be copied.

Throws:

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

swap

public void swap(long firstIndex,
 long secondIndex)

This implementation swaps two elements by AbstractBitArray.getBit(long) and setBit(long, boolean) methods.

Specified by:

swap in interface ArrayExchanger

Specified by:

swap in interface UpdatableArray

Parameters:

firstIndex - first index of element to exchange.

secondIndex - second index of element to exchange.

Throws:

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

swap

public void swap(long firstIndex,
 long secondIndex,
 long count)

This implementation is based on a loop of calls of swap(long, long) method.

Specified by:

swap in interface UpdatableArray

Parameters:

firstIndex - starting first index of element to exchange.

secondIndex - starting second index of element to exchange.

count - the number of elements to be exchanged.

Throws:

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

copy

public UpdatableArray copy(Array src)

This implementation calls defaultCopy(thisInstance, src).

Specified by:

copy in interface UpdatableArray

Parameters:

src - the source array.

Returns:

a reference to this array.

Throws:

NullPointerException - if src argument is null.

IllegalArgumentException - if the source and this element types do not match.

See Also:

• Arrays.copy(ArrayContext, UpdatableArray, Array)

swap

public UpdatableArray swap(UpdatableArray another)

This implementation calls defaultSwap(thisInstance, another).

Specified by:

swap in interface UpdatableArray

Parameters:

another - another array.

Returns:

a reference to this array.

Throws:

NullPointerException - if another argument is null.

IllegalArgumentException - if another and this element types do not match.

setNonNew

public void setNonNew()

This implementation calls setNewStatus(false).

Specified by:

setNonNew in interface UpdatableArray

asCopyOnNextWrite

public UpdatableArray asCopyOnNextWrite()

This implementation returns updatableClone(Arrays.SMM).

Specified by:

asCopyOnNextWrite in interface Array

Specified by:

asCopyOnNextWrite in interface UpdatableArray

Overrides:

asCopyOnNextWrite in class AbstractBitArray

Returns:

a copy of this object.

See Also:

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

asUnresizable

public UpdatableBitArray asUnresizable()

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

Specified by:

asUnresizable in interface UpdatableArray

Specified by:

asUnresizable in interface UpdatableBitArray

Specified by:

asUnresizable in interface UpdatablePArray

Specified by:

asUnresizable in interface UpdatablePFixedArray

Returns:

an unresizable view of this array.

See Also:

• Array.isUnresizable()

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

Overrides:

toString in class AbstractBitArray

Returns:

a brief string description of this object.

setBit

public void setBit(long index)

Description copied from interface: UpdatableBitArray

Sets the bit #index to 1 (true).

Specified by:

setBit in interface UpdatableBitArray

Parameters:

index - index of element to replace.

clearBit

public void clearBit(long index)

Clears the bit #index to 0 (false).

Specified by:

clearBit in interface UpdatableBitArray

Parameters:

index - index of element to replace.

Throws:

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

setBits

public UpdatableBitArray setBits(long arrayPos,
 long[] srcArray,
 long srcArrayOffset,
 long count)

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

Specified by:

setBits in interface UpdatableBitArray

Parameters:

arrayPos - starting position in this AlgART array.

srcArray - the source packed bit array.

srcArrayOffset - starting position in the source packed bit array.

count - the number of bits to be copied.

Returns:

a reference to this AlgART array.

Throws:

NullPointerException - if srcArray argument is null.

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

See Also:

• Array.getData(long, Object, int, int)
• BitArray.getBits(long, long[], long, long)
• PackedBitArrays