Class LazyArray

java.lang.Object

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

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

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

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

public class LazyArray
extends AbstractConstantArray

LazyArray is a backing class for a JSArray that allows array elements to be supplied on demand (i.e., lazily) from a list generator. Whenever a lazy array is written to, the entire lazy array is enumerated and copied and loses its lazy lookup property.

Nested Class Summary

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.CreateWritableProfileAccess, ScriptArray.DefaultIterator, ScriptArray.SetLengthProfileAccess

Field Summary

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

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
ScriptArray	addRangeImpl(JSDynamicObject object, long offset, int size)	This method grows the array by adding more elements of a given size.
Object	cloneArray(JSDynamicObject object)
static LazyArray	createLazyArray()
AbstractWritableArray	createWriteableDouble(JSDynamicObject object, long index, double value, com.oracle.truffle.api.nodes.Node node, ScriptArray.CreateWritableProfileAccess profile)
AbstractWritableArray	createWriteableInt(JSDynamicObject object, long index, int value, com.oracle.truffle.api.nodes.Node node, ScriptArray.CreateWritableProfileAccess profile)
AbstractWritableArray	createWriteableJSObject(JSDynamicObject object, long index, JSDynamicObject value, com.oracle.truffle.api.nodes.Node node, ScriptArray.CreateWritableProfileAccess profile)
AbstractWritableArray	createWriteableObject(JSDynamicObject object, long index, Object value, com.oracle.truffle.api.nodes.Node node, ScriptArray.CreateWritableProfileAccess profile)
ScriptArray	deleteElementImpl(JSDynamicObject object, long index, boolean strict)
Object	getElementInBounds(JSDynamicObject object, int index)
Object	getElementInBounds(JSDynamicObject object, int index, ListGetNode listGetNode)
boolean	hasElement(JSDynamicObject object, long index)
int	lengthInt(JSDynamicObject object)
ScriptArray	removeRangeImpl(JSDynamicObject object, long start, long end)	This function deletes all elements in the range from [start..end[.
ScriptArray	setLengthImpl(JSDynamicObject object, long len, com.oracle.truffle.api.nodes.Node node, ScriptArray.SetLengthProfileAccess profile)
protected DynamicArray	withIntegrityLevel(int newIntegrityLevel)

Methods inherited from class com.oracle.truffle.js.runtime.array.dyn.AbstractConstantArray

firstElementIndex, getElement, getElementInBounds, hasHoles, isInBoundsFast, lastElementIndex, length, nextElementIndex, previousElementIndex, setElementImpl

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

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

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

addRange, asIterable, canDeleteElement, cast, createConstantArray, createConstantEmptyArray, deleteElement, hasHolesOrUnused, isHolesType, isInstance, makeMultiRangeList, makeRangeList, nextPower, ownPropertyKeys, ownPropertyKeysContiguous, ownPropertyKeysHoles, removeRange, removeRange, setElement, setLength, setLength, shiftRange, shiftRangeImpl, toArray, traceArrayTransition, traceWrite, valueIsByte

Methods inherited from class java.lang.Object

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

Constructor Details

LazyArray

protected LazyArray(int integrityLevel,
 DynamicArray.DynamicArrayCache cache)

Method Details

createLazyArray

public static LazyArray createLazyArray()

withIntegrityLevel

protected DynamicArray withIntegrityLevel(int newIntegrityLevel)

Specified by:

withIntegrityLevel in class DynamicArray

getElementInBounds

public Object getElementInBounds(JSDynamicObject object,
 int index)

Specified by:

getElementInBounds in class AbstractConstantArray

getElementInBounds

public Object getElementInBounds(JSDynamicObject object,
 int index,
 ListGetNode listGetNode)

hasElement

public boolean hasElement(JSDynamicObject object,
 long index)

Specified by:

hasElement in class ScriptArray

Returns:

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

lengthInt

public int lengthInt(JSDynamicObject object)

Specified by:

lengthInt in class ScriptArray

createWriteableObject

public AbstractWritableArray createWriteableObject(JSDynamicObject object,
 long index,
 Object value,
 com.oracle.truffle.api.nodes.Node node,
 ScriptArray.CreateWritableProfileAccess profile)

Specified by:

createWriteableObject in class AbstractConstantArray

createWriteableDouble

public AbstractWritableArray createWriteableDouble(JSDynamicObject object,
 long index,
 double value,
 com.oracle.truffle.api.nodes.Node node,
 ScriptArray.CreateWritableProfileAccess profile)

Specified by:

createWriteableDouble in class AbstractConstantArray

createWriteableInt

public AbstractWritableArray createWriteableInt(JSDynamicObject object,
 long index,
 int value,
 com.oracle.truffle.api.nodes.Node node,
 ScriptArray.CreateWritableProfileAccess profile)

Specified by:

createWriteableInt in class AbstractConstantArray

createWriteableJSObject

public AbstractWritableArray createWriteableJSObject(JSDynamicObject object,
 long index,
 JSDynamicObject value,
 com.oracle.truffle.api.nodes.Node node,
 ScriptArray.CreateWritableProfileAccess profile)

Specified by:

createWriteableJSObject in class AbstractConstantArray

deleteElementImpl

public ScriptArray deleteElementImpl(JSDynamicObject object,
 long index,
 boolean strict)

Specified by:

deleteElementImpl in class ScriptArray

setLengthImpl

public ScriptArray setLengthImpl(JSDynamicObject object,
 long len,
 com.oracle.truffle.api.nodes.Node node,
 ScriptArray.SetLengthProfileAccess profile)

Specified by:

setLengthImpl in class ScriptArray

removeRangeImpl

public ScriptArray removeRangeImpl(JSDynamicObject object,
 long start,
 long end)

Description copied from class: ScriptArray

This function deletes all elements in the range from [start..end[. This is equivalent to shifting the whole array, starting with element index end, by end-start positions to the left. Can be used by e.g. Array.prototype.splice;

Specified by:

removeRangeImpl in class ScriptArray

addRangeImpl

public ScriptArray addRangeImpl(JSDynamicObject object,
 long offset,
 int size)

Description copied from class: ScriptArray

This method grows the array by adding more elements of a given size. An offset parameter can be used to specify where the new elements have to be added (starting from zero). The operation is equivalent to shifting (right) the whole array or its part as defined by the offset parameter.

Specified by:

addRangeImpl in class ScriptArray

Parameters:

offset - starting offset position

size - size of the inserted empty array

Returns:

a ScriptArray instance with the new size

cloneArray

public Object cloneArray(JSDynamicObject object)

Specified by:

cloneArray in class DynamicArray