com.oracle.truffle.js.runtime.array.dyn

Class AbstractWritableArray

java.lang.Object

com.oracle.truffle.js.runtime.array.ScriptArray

com.oracle.truffle.js.runtime.array.DynamicArray

com.oracle.truffle.js.runtime.array.dyn.AbstractWritableArray

Direct Known Subclasses:

AbstractDoubleArray, AbstractIntArray, AbstractJSObjectArray, AbstractObjectArray

public abstract class AbstractWritableArray
extends DynamicArray

Base class of a javascript dynamic writable array. The array implementation uses three write access modes:

• InBoundsFast: Accessed index is in bounds of the physical and logical array. So no housekeeping should usually be necessary in this access mode.
• InBounds: Accessed index is in bounds of the physical backing array. Little housekeeping.
• Supported: If a write to this index is supported by the array. Full housekeeping.
• Not Supported: If a write to this index is not supported by the array. The array will transition to another implementation that supports the written index.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static interface	AbstractWritableArray.SetSupportedProfileAccess

Nested classes/interfaces inherited from class com.oracle.truffle.js.runtime.array.DynamicArray

DynamicArray.DynamicArrayCache

Nested classes/interfaces inherited from class com.oracle.truffle.js.runtime.array.ScriptArray

ScriptArray.DefaultIterator, ScriptArray.ProfileAccess, ScriptArray.ProfileHolder, ScriptArray.SetLengthProfileAccess

Field Summary

Fields

Modifier and Type	Field and Description
protected static AbstractWritableArray.SetSupportedProfileAccess	SET_SUPPORTED_PROFILE_ACCESS

Fields inherited from class com.oracle.truffle.js.runtime.array.DynamicArray

cache, INTEGRITY_LEVEL_FROZEN, INTEGRITY_LEVEL_FROZEN_LENGTH_READONLY, INTEGRITY_LEVEL_MASK, INTEGRITY_LEVEL_NONE, INTEGRITY_LEVEL_NONE_LENGTH_READONLY, INTEGRITY_LEVEL_NOT_EXTENSIBLE, INTEGRITY_LEVEL_NOT_EXTENSIBLE_LENGTH_READONLY, INTEGRITY_LEVEL_SEALED, INTEGRITY_LEVEL_SEALED_LENGTH_READONLY, INTEGRITY_LEVELS, integrityLevel, LENGTH_NOT_WRITABLE, LENGTH_WRITABLE_MASK

Fields inherited from class com.oracle.truffle.js.runtime.array.ScriptArray

EMPTY_OBJECT_ARRAY, SET_LENGTH_PROFILE

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractWritableArray(int integrityLevel, DynamicArray.DynamicArrayCache cache)

Method Summary

Modifier and Type	Method and Description
abstract Object	allocateArray(int length)
protected void	clearUnusedArea(com.oracle.truffle.api.object.DynamicObject object, int startIdx, int endIdx, int arrayOffset, ScriptArray.ProfileHolder profile) After shortening the array, the now unused area has to be cleared.
boolean	containsHoles(com.oracle.truffle.api.object.DynamicObject object, long index)
protected int	countHoles(com.oracle.truffle.api.object.DynamicObject object)
static ScriptArray.ProfileHolder	createSetSupportedProfile()
protected ScriptArray	deleteElementHoles(com.oracle.truffle.api.object.DynamicObject object, long index)
protected void	fillHoles(com.oracle.truffle.api.object.DynamicObject object, int internalIndex, int grown, ScriptArray.ProfileHolder profile)
protected abstract int	getArrayCapacity(com.oracle.truffle.api.object.DynamicObject object)
protected int	getArrayOffset(com.oracle.truffle.api.object.DynamicObject object) The arrayOffset (int) is the first element in internal array.
Object	getElement(com.oracle.truffle.api.object.DynamicObject object, long index)
Object	getElementInBounds(com.oracle.truffle.api.object.DynamicObject object, long index)
abstract Object	getInBoundsFast(com.oracle.truffle.api.object.DynamicObject object, int index)
double	getInBoundsFastDouble(com.oracle.truffle.api.object.DynamicObject object, int index)
int	getInBoundsFastInt(com.oracle.truffle.api.object.DynamicObject object, int index)
protected long	getIndexOffset(com.oracle.truffle.api.object.DynamicObject object) The indexOffset (int) is the first element is in array[indexOffset + arrayOffset].
protected static int	getUsedLength(com.oracle.truffle.api.object.DynamicObject object)
boolean	hasElement(com.oracle.truffle.api.object.DynamicObject object, long index)
protected void	incrementHolesCount(com.oracle.truffle.api.object.DynamicObject object, int offset)
protected abstract boolean	isHolePrepared(com.oracle.truffle.api.object.DynamicObject object, int index) Returns true when the array contains a hole at that index.
boolean	isInBounds(com.oracle.truffle.api.object.DynamicObject object, int index)
boolean	isInBoundsFast(com.oracle.truffle.api.object.DynamicObject object, long index) Returns true if the index can be written using inBoundsFast access mode.
boolean	isSparse(com.oracle.truffle.api.object.DynamicObject object, long index)
abstract boolean	isSupported(com.oracle.truffle.api.object.DynamicObject object, long index)
boolean	isSupportedContiguous(com.oracle.truffle.api.object.DynamicObject object, long index)
boolean	isSupportedHoles(com.oracle.truffle.api.object.DynamicObject object, long index)
static boolean	isSupportedZeroBased(com.oracle.truffle.api.object.DynamicObject object, int index)
long	length(com.oracle.truffle.api.object.DynamicObject object)
int	lengthInt(com.oracle.truffle.api.object.DynamicObject object)
protected abstract void	moveRangePrepared(com.oracle.truffle.api.object.DynamicObject object, int src, int dst, int len) Move len elements from src to dst.
long	nextElementIndex(com.oracle.truffle.api.object.DynamicObject object, long index) Returns the next index.
protected long	nextElementIndexHoles(com.oracle.truffle.api.object.DynamicObject object, long index0)
protected long	nextElementIndexZeroBased(com.oracle.truffle.api.object.DynamicObject object, long index)
protected abstract int	prepareInBounds(com.oracle.truffle.api.object.DynamicObject object, int index, ScriptArray.ProfileHolder profile)
protected int	prepareInBoundsContiguous(com.oracle.truffle.api.object.DynamicObject object, int index, ScriptArray.ProfileHolder profile)
protected abstract int	prepareInBoundsFast(com.oracle.truffle.api.object.DynamicObject object, long index)
protected int	prepareInBoundsHoles(com.oracle.truffle.api.object.DynamicObject object, int index, ScriptArray.ProfileHolder profile)
protected static void	prepareInBoundsZeroBased(com.oracle.truffle.api.object.DynamicObject object, int index, ScriptArray.ProfileHolder profile)
protected abstract int	prepareSupported(com.oracle.truffle.api.object.DynamicObject object, int index, ScriptArray.ProfileHolder profile)
protected int	prepareSupportedContiguous(com.oracle.truffle.api.object.DynamicObject object, int index, ScriptArray.ProfileHolder profile)
protected int	prepareSupportedHoles(com.oracle.truffle.api.object.DynamicObject object, int index, ScriptArray.ProfileHolder profile)
protected void	prepareSupportedZeroBased(com.oracle.truffle.api.object.DynamicObject object, int index, ScriptArray.ProfileHolder profile)
long	previousElementIndex(com.oracle.truffle.api.object.DynamicObject object, long index) Returns the previous index.
protected long	previousElementIndexHoles(com.oracle.truffle.api.object.DynamicObject object, long index0)
protected ScriptArray	removeRangeContiguous(com.oracle.truffle.api.object.DynamicObject object, long start, long end)
protected ScriptArray	removeRangeHoles(com.oracle.truffle.api.object.DynamicObject object, long start, long end)
protected abstract void	resizeArray(com.oracle.truffle.api.object.DynamicObject object, int newCapacity, int oldCapacity, int offset)
protected void	setArrayOffset(com.oracle.truffle.api.object.DynamicObject object, int value)
protected static void	setArrayProperties(com.oracle.truffle.api.object.DynamicObject object, Object array, long length, int usedLength, long indexOffset, int arrayOffset)
protected abstract void	setHoleValue(com.oracle.truffle.api.object.DynamicObject object, int index)
protected void	setIndexOffset(com.oracle.truffle.api.object.DynamicObject object, long value)
ScriptArray	setLengthImpl(com.oracle.truffle.api.object.DynamicObject object, long length, ScriptArray.ProfileHolder profile)
protected abstract void	setLengthLess(com.oracle.truffle.api.object.DynamicObject object, long length, ScriptArray.ProfileHolder profile)
protected void	setLengthLessContiguous(com.oracle.truffle.api.object.DynamicObject object, long length, ScriptArray.ProfileHolder profile)
protected void	setLengthLessZeroBased(com.oracle.truffle.api.object.DynamicObject object, long length, ScriptArray.ProfileHolder profile)
Object[]	toArray(com.oracle.truffle.api.object.DynamicObject object) Creates an Object[] from this array, of size array.length.
protected Object[]	toArrayZeroBased(com.oracle.truffle.api.object.DynamicObject object)
AbstractWritableArray	toContiguous(com.oracle.truffle.api.object.DynamicObject object, long index, Object value)
abstract AbstractWritableArray	toDouble(com.oracle.truffle.api.object.DynamicObject object, long index, double value)
abstract AbstractWritableArray	toHoles(com.oracle.truffle.api.object.DynamicObject object, long index, Object value)
ScriptArray	toNonContiguous(com.oracle.truffle.api.object.DynamicObject object, int index, Object value, ScriptArray.ProfileHolder profile)
AbstractWritableArray	toNonHoles(com.oracle.truffle.api.object.DynamicObject object, long index, Object value)
abstract AbstractWritableArray	toObject(com.oracle.truffle.api.object.DynamicObject object, long index, Object value)
SparseArray	toSparse(com.oracle.truffle.api.object.DynamicObject object, long index, Object value)
protected void	traceWriteValue(String access, int index, Object value)
protected abstract AbstractWritableArray	withIntegrityLevel(int newIntegrityLevel)

Methods inherited from class com.oracle.truffle.js.runtime.array.DynamicArray

array, cloneArray, createCache, freeze, isExtensible, isFrozen, isLengthNotWritable, isSealed, preventExtensions, seal, setIntegrityLevel, setLengthNotWritable, toString

Methods inherited from class com.oracle.truffle.js.runtime.array.ScriptArray

addRange, addRangeImpl, asIterable, canDeleteElement, cast, createConstantArray, createConstantEmptyArray, createSetLengthProfile, deleteElement, deleteElementImpl, firstElementIndex, hasHoles, isHolesType, isInstance, lastElementIndex, makeMultiRangeList, makeRangeList, nextPower, ownPropertyKeys, ownPropertyKeysContiguous, ownPropertyKeysHoles, removeRange, removeRange, removeRangeImpl, setElement, setElementImpl, setLength, setLength, toString, traceArrayTransition, traceWrite, valueIsByte

Methods inherited from class java.lang.Object

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

Field Detail

SET_SUPPORTED_PROFILE_ACCESS

protected static final AbstractWritableArray.SetSupportedProfileAccess SET_SUPPORTED_PROFILE_ACCESS

Constructor Detail

AbstractWritableArray

protected AbstractWritableArray(int integrityLevel,
                                DynamicArray.DynamicArrayCache cache)

Method Detail

setArrayProperties

protected static final void setArrayProperties(com.oracle.truffle.api.object.DynamicObject object,
                                               Object array,
                                               long length,
                                               int usedLength,
                                               long indexOffset,
                                               int arrayOffset)

isInBoundsFast

public final boolean isInBoundsFast(com.oracle.truffle.api.object.DynamicObject object,
                                    long index)

Returns true if the index can be written using inBoundsFast access mode.

Overrides:

isInBoundsFast in class ScriptArray

prepareInBoundsFast

protected abstract int prepareInBoundsFast(com.oracle.truffle.api.object.DynamicObject object,
                                           long index)

isInBounds

public final boolean isInBounds(com.oracle.truffle.api.object.DynamicObject object,
                                int index)

prepareInBounds

protected abstract int prepareInBounds(com.oracle.truffle.api.object.DynamicObject object,
                                       int index,
                                       ScriptArray.ProfileHolder profile)

prepareInBoundsZeroBased

protected static void prepareInBoundsZeroBased(com.oracle.truffle.api.object.DynamicObject object,
                                               int index,
                                               ScriptArray.ProfileHolder profile)

getUsedLength

protected static int getUsedLength(com.oracle.truffle.api.object.DynamicObject object)

prepareInBoundsContiguous

protected final int prepareInBoundsContiguous(com.oracle.truffle.api.object.DynamicObject object,
                                              int index,
                                              ScriptArray.ProfileHolder profile)

prepareInBoundsHoles

protected final int prepareInBoundsHoles(com.oracle.truffle.api.object.DynamicObject object,
                                         int index,
                                         ScriptArray.ProfileHolder profile)

containsHoles

public boolean containsHoles(com.oracle.truffle.api.object.DynamicObject object,
                             long index)

isSupported

public abstract boolean isSupported(com.oracle.truffle.api.object.DynamicObject object,
                                    long index)

isSupportedZeroBased

public static boolean isSupportedZeroBased(com.oracle.truffle.api.object.DynamicObject object,
                                           int index)

isSupportedContiguous

public final boolean isSupportedContiguous(com.oracle.truffle.api.object.DynamicObject object,
                                           long index)

isSupportedHoles

public final boolean isSupportedHoles(com.oracle.truffle.api.object.DynamicObject object,
                                      long index)

prepareSupported

protected abstract int prepareSupported(com.oracle.truffle.api.object.DynamicObject object,
                                        int index,
                                        ScriptArray.ProfileHolder profile)

prepareSupportedZeroBased

protected final void prepareSupportedZeroBased(com.oracle.truffle.api.object.DynamicObject object,
                                               int index,
                                               ScriptArray.ProfileHolder profile)

prepareSupportedContiguous

protected final int prepareSupportedContiguous(com.oracle.truffle.api.object.DynamicObject object,
                                               int index,
                                               ScriptArray.ProfileHolder profile)

prepareSupportedHoles

protected final int prepareSupportedHoles(com.oracle.truffle.api.object.DynamicObject object,
                                          int index,
                                          ScriptArray.ProfileHolder profile)

incrementHolesCount

protected void incrementHolesCount(com.oracle.truffle.api.object.DynamicObject object,
                                   int offset)

setHoleValue

protected abstract void setHoleValue(com.oracle.truffle.api.object.DynamicObject object,
                                     int index)

getArrayCapacity

protected abstract int getArrayCapacity(com.oracle.truffle.api.object.DynamicObject object)

getArrayOffset

protected int getArrayOffset(com.oracle.truffle.api.object.DynamicObject object)

The arrayOffset (int) is the first element in internal array.

setArrayOffset

protected void setArrayOffset(com.oracle.truffle.api.object.DynamicObject object,
                              int value)

getIndexOffset

protected long getIndexOffset(com.oracle.truffle.api.object.DynamicObject object)

The indexOffset (int) is the first element is in array[indexOffset + arrayOffset].

setIndexOffset

protected void setIndexOffset(com.oracle.truffle.api.object.DynamicObject object,
                              long value)

fillHoles

protected void fillHoles(com.oracle.truffle.api.object.DynamicObject object,
                         int internalIndex,
                         int grown,
                         ScriptArray.ProfileHolder profile)

toDouble

public abstract AbstractWritableArray toDouble(com.oracle.truffle.api.object.DynamicObject object,
                                               long index,
                                               double value)

toObject

public abstract AbstractWritableArray toObject(com.oracle.truffle.api.object.DynamicObject object,
                                               long index,
                                               Object value)

toContiguous

public AbstractWritableArray toContiguous(com.oracle.truffle.api.object.DynamicObject object,
                                          long index,
                                          Object value)

toHoles

public abstract AbstractWritableArray toHoles(com.oracle.truffle.api.object.DynamicObject object,
                                              long index,
                                              Object value)

toNonHoles

public AbstractWritableArray toNonHoles(com.oracle.truffle.api.object.DynamicObject object,
                                        long index,
                                        Object value)

toSparse

public final SparseArray toSparse(com.oracle.truffle.api.object.DynamicObject object,
                                  long index,
                                  Object value)

resizeArray

protected abstract void resizeArray(com.oracle.truffle.api.object.DynamicObject object,
                                    int newCapacity,
                                    int oldCapacity,
                                    int offset)

isSparse

public final boolean isSparse(com.oracle.truffle.api.object.DynamicObject object,
                              long index)

hasElement

public boolean hasElement(com.oracle.truffle.api.object.DynamicObject object,
                          long index)

Specified by:

hasElement in class ScriptArray

Returns:

true if array has an element (not a hole) at this index.

nextElementIndex

public long nextElementIndex(com.oracle.truffle.api.object.DynamicObject object,
                             long index)

Description copied from class: ScriptArray

Returns the next index. The index is guaranteed either to exist, or be MAX_SAFE_INTEGER. Reason for MAX_SAFE_INTEGER is: this array could be the prototype of another one; returning the length() of this array would be wrong, if the inheriting array is longer, but has a hole at length().

Specified by:

nextElementIndex in class ScriptArray

isHolePrepared

protected abstract boolean isHolePrepared(com.oracle.truffle.api.object.DynamicObject object,
                                          int index)

Returns true when the array contains a hole at that index. The index is a prepared (internal) index.

nextElementIndexHoles

protected final long nextElementIndexHoles(com.oracle.truffle.api.object.DynamicObject object,
                                           long index0)

nextElementIndexZeroBased

protected final long nextElementIndexZeroBased(com.oracle.truffle.api.object.DynamicObject object,
                                               long index)

previousElementIndex

public long previousElementIndex(com.oracle.truffle.api.object.DynamicObject object,
                                 long index)

Description copied from class: ScriptArray

Returns the previous index. The index is guaranteed either to exist, or be smaller than firstElementIndex().

Specified by:

previousElementIndex in class ScriptArray

previousElementIndexHoles

protected final long previousElementIndexHoles(com.oracle.truffle.api.object.DynamicObject object,
                                               long index0)

length

public final long length(com.oracle.truffle.api.object.DynamicObject object)

Specified by:

length in class ScriptArray

lengthInt

public final int lengthInt(com.oracle.truffle.api.object.DynamicObject object)

Specified by:

lengthInt in class ScriptArray

setLengthImpl

public final ScriptArray setLengthImpl(com.oracle.truffle.api.object.DynamicObject object,
                                       long length,
                                       ScriptArray.ProfileHolder profile)

Specified by:

setLengthImpl in class ScriptArray

setLengthLess

protected abstract void setLengthLess(com.oracle.truffle.api.object.DynamicObject object,
                                      long length,
                                      ScriptArray.ProfileHolder profile)

setLengthLessZeroBased

protected void setLengthLessZeroBased(com.oracle.truffle.api.object.DynamicObject object,
                                      long length,
                                      ScriptArray.ProfileHolder profile)

setLengthLessContiguous

protected final void setLengthLessContiguous(com.oracle.truffle.api.object.DynamicObject object,
                                             long length,
                                             ScriptArray.ProfileHolder profile)

clearUnusedArea

protected void clearUnusedArea(com.oracle.truffle.api.object.DynamicObject object,
                               int startIdx,
                               int endIdx,
                               int arrayOffset,
                               ScriptArray.ProfileHolder profile)

After shortening the array, the now unused area has to be cleared.

getElement

public final Object getElement(com.oracle.truffle.api.object.DynamicObject object,
                               long index)

Specified by:

getElement in class ScriptArray

getElementInBounds

public final Object getElementInBounds(com.oracle.truffle.api.object.DynamicObject object,
                                       long index)

Specified by:

getElementInBounds in class ScriptArray

getInBoundsFast

public abstract Object getInBoundsFast(com.oracle.truffle.api.object.DynamicObject object,
                                       int index)

getInBoundsFastInt

public int getInBoundsFastInt(com.oracle.truffle.api.object.DynamicObject object,
                              int index)
                       throws com.oracle.truffle.api.nodes.UnexpectedResultException

Throws:

com.oracle.truffle.api.nodes.UnexpectedResultException

getInBoundsFastDouble

public double getInBoundsFastDouble(com.oracle.truffle.api.object.DynamicObject object,
                                    int index)
                             throws com.oracle.truffle.api.nodes.UnexpectedResultException

Throws:

com.oracle.truffle.api.nodes.UnexpectedResultException

toArray

public Object[] toArray(com.oracle.truffle.api.object.DynamicObject object)

Description copied from class: ScriptArray

Creates an Object[] from this array, of size array.length. Does not check the prototype chain, i.e. result can be wrong. Use JSToObjectArrayNode for more correct results.

Specified by:

toArray in class ScriptArray

toArrayZeroBased

protected final Object[] toArrayZeroBased(com.oracle.truffle.api.object.DynamicObject object)

deleteElementHoles

protected final ScriptArray deleteElementHoles(com.oracle.truffle.api.object.DynamicObject object,
                                               long index)

traceWriteValue

protected final void traceWriteValue(String access,
                                     int index,
                                     Object value)

toNonContiguous

public ScriptArray toNonContiguous(com.oracle.truffle.api.object.DynamicObject object,
                                   int index,
                                   Object value,
                                   ScriptArray.ProfileHolder profile)

withIntegrityLevel

protected abstract AbstractWritableArray withIntegrityLevel(int newIntegrityLevel)

Specified by:

withIntegrityLevel in class DynamicArray

allocateArray

public abstract Object allocateArray(int length)

removeRangeContiguous

protected final ScriptArray removeRangeContiguous(com.oracle.truffle.api.object.DynamicObject object,
                                                  long start,
                                                  long end)

removeRangeHoles

protected final ScriptArray removeRangeHoles(com.oracle.truffle.api.object.DynamicObject object,
                                             long start,
                                             long end)

countHoles

protected final int countHoles(com.oracle.truffle.api.object.DynamicObject object)

moveRangePrepared

protected abstract void moveRangePrepared(com.oracle.truffle.api.object.DynamicObject object,
                                          int src,
                                          int dst,
                                          int len)

Move len elements from src to dst.

createSetSupportedProfile

public static ScriptArray.ProfileHolder createSetSupportedProfile()