com.oracle.truffle.js.runtime.array

Class TypedArray

java.lang.Object

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

com.oracle.truffle.js.runtime.array.TypedArray

Direct Known Subclasses:

TypedArray.TypedBigIntArray, TypedArray.TypedFloatArray, TypedArray.TypedIntArray

public abstract class TypedArray
extends ScriptArray

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TypedArray.AbstractUint32Array
static class	TypedArray.AbstractUint8ClampedArray
static class	TypedArray.BigInt64Array
static class	TypedArray.BigUint64Array
static class	TypedArray.DirectBigInt64Array
static class	TypedArray.DirectBigUint64Array
static class	TypedArray.DirectFloat32Array
static class	TypedArray.DirectFloat64Array
static class	TypedArray.DirectInt16Array
static class	TypedArray.DirectInt32Array
static class	TypedArray.DirectInt8Array
static class	TypedArray.DirectUint16Array
static class	TypedArray.DirectUint32Array
static class	TypedArray.DirectUint8Array
static class	TypedArray.DirectUint8ClampedArray
static class	TypedArray.Float32Array
static class	TypedArray.Float64Array
static class	TypedArray.Int16Array
static class	TypedArray.Int32Array
static class	TypedArray.Int8Array
static class	TypedArray.InteropBigInt64Array
static class	TypedArray.InteropBigUint64Array
static class	TypedArray.InteropFloat32Array
static class	TypedArray.InteropFloat64Array
static class	TypedArray.InteropInt16Array
static class	TypedArray.InteropInt32Array
static class	TypedArray.InteropInt8Array
static class	TypedArray.InteropUint16Array
static class	TypedArray.InteropUint32Array
static class	TypedArray.InteropUint8Array
static class	TypedArray.InteropUint8ClampedArray
static class	TypedArray.TypedBigIntArray
static class	TypedArray.TypedFloatArray
static class	TypedArray.TypedIntArray
static class	TypedArray.Uint16Array
static class	TypedArray.Uint32Array
static class	TypedArray.Uint8Array
static class	TypedArray.Uint8ClampedArray

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 byte	BUFFER_TYPE_ARRAY
protected static byte	BUFFER_TYPE_DIRECT
protected static byte	BUFFER_TYPE_INTEROP

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	TypedArray(TypedArrayFactory factory, boolean offset, byte bufferType)

Method Summary

Modifier and Type	Method and Description
ScriptArray	addRangeImpl(com.oracle.truffle.api.object.DynamicObject object, long atOffset, int size) This method grows the array by adding more elements of a given size.
int	bytesPerElement()
ScriptArray	deleteElementImpl(com.oracle.truffle.api.object.DynamicObject object, long index, boolean strict)
static TypedArrayFactory[]	factories()
static TypedArrayFactory[]	factories(JSContext context)
long	firstElementIndex(com.oracle.truffle.api.object.DynamicObject object) First element index (inclusive).
ScriptArray	freeze()
abstract Object	getBufferElement(Object buffer, int index, boolean littleEndian, com.oracle.truffle.api.interop.InteropLibrary interop)
static com.oracle.truffle.api.object.DynamicObject	getBufferFromTypedArray(com.oracle.truffle.api.object.DynamicObject typedArray) Get ArrayBuffer from TypedArray.
protected static byte[]	getByteArray(Object buffer) Get byte[] from ArrayBuffer.
protected static ByteBuffer	getDirectByteBuffer(Object buffer) Get ByteBuffer from ArrayBuffer with unspecified byte order.
TypedArrayFactory	getFactory()
String	getName()
protected int	getOffset(com.oracle.truffle.api.object.DynamicObject object)
boolean	hasElement(com.oracle.truffle.api.object.DynamicObject object, long index)
boolean	hasHoles(com.oracle.truffle.api.object.DynamicObject object)
boolean	hasOffset()
boolean	isDirect()
boolean	isFrozen()
boolean	isHolesType() Returns true when the this array could have hole values in it.
boolean	isInterop()
boolean	isLengthNotWritable()
boolean	isSealed()
long	lastElementIndex(com.oracle.truffle.api.object.DynamicObject object) Last element index (inclusive).
long	length(com.oracle.truffle.api.object.DynamicObject object)
int	lengthInt(com.oracle.truffle.api.object.DynamicObject object)
long	nextElementIndex(com.oracle.truffle.api.object.DynamicObject object, long index) Returns the next index.
ScriptArray	preventExtensions()
long	previousElementIndex(com.oracle.truffle.api.object.DynamicObject object, long index) Returns the previous index.
ScriptArray	removeRangeImpl(com.oracle.truffle.api.object.DynamicObject object, long start, long end) This function deletes all elements in the range from [start..end[.
ScriptArray	seal()
abstract void	setBufferElement(Object buffer, int index, boolean littleEndian, Object value, com.oracle.truffle.api.interop.InteropLibrary interop)
TypedArray	setLengthImpl(com.oracle.truffle.api.object.DynamicObject object, long len, ScriptArray.ProfileHolder profile)
ScriptArray	setLengthNotWritable()
Object[]	toArray(com.oracle.truffle.api.object.DynamicObject object) Creates an Object[] from this array, of size array.length.
protected static JSException	unsupportedBufferAccess(Object buffer, com.oracle.truffle.api.interop.UnsupportedMessageException e)

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

addRange, asIterable, canDeleteElement, cast, createConstantArray, createConstantEmptyArray, createSetLengthProfile, deleteElement, getElement, getElementInBounds, isExtensible, isInBoundsFast, isInstance, makeMultiRangeList, makeRangeList, nextPower, ownPropertyKeys, ownPropertyKeysContiguous, ownPropertyKeysHoles, removeRange, removeRange, setElement, setElementImpl, setLength, setLength, toString, traceArrayTransition, traceWrite, valueIsByte

Methods inherited from class java.lang.Object

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

Field Detail

BUFFER_TYPE_ARRAY

protected static final byte BUFFER_TYPE_ARRAY

See Also:

Constant Field Values

BUFFER_TYPE_DIRECT

protected static final byte BUFFER_TYPE_DIRECT

See Also:

Constant Field Values

BUFFER_TYPE_INTEROP

protected static final byte BUFFER_TYPE_INTEROP

See Also:

Constant Field Values

Constructor Detail

TypedArray

protected TypedArray(TypedArrayFactory factory,
                     boolean offset,
                     byte bufferType)

Method Detail

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 TypedArray setLengthImpl(com.oracle.truffle.api.object.DynamicObject object,
                                      long len,
                                      ScriptArray.ProfileHolder profile)

Specified by:

setLengthImpl in class ScriptArray

firstElementIndex

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

Description copied from class: ScriptArray

First element index (inclusive).

Specified by:

firstElementIndex in class ScriptArray

lastElementIndex

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

Description copied from class: ScriptArray

Last element index (inclusive).

Specified by:

lastElementIndex in class ScriptArray

nextElementIndex

public final 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

previousElementIndex

public final 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

toArray

public final 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

deleteElementImpl

public final ScriptArray deleteElementImpl(com.oracle.truffle.api.object.DynamicObject object,
                                           long index,
                                           boolean strict)

Specified by:

deleteElementImpl in class ScriptArray

hasElement

public final 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.

getDirectByteBuffer

protected static ByteBuffer getDirectByteBuffer(Object buffer)

Get ByteBuffer from ArrayBuffer with unspecified byte order.

getByteArray

protected static byte[] getByteArray(Object buffer)

Get byte[] from ArrayBuffer.

getBufferFromTypedArray

public static com.oracle.truffle.api.object.DynamicObject getBufferFromTypedArray(com.oracle.truffle.api.object.DynamicObject typedArray)

Get ArrayBuffer from TypedArray.

getOffset

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

getFactory

public final TypedArrayFactory getFactory()

bytesPerElement

public final int bytesPerElement()

getName

public final String getName()

isHolesType

public boolean isHolesType()

Description copied from class: ScriptArray

Returns true when the this array could have hole values in it. Doesn't tell whether it actually HAS holes.

Overrides:

isHolesType in class ScriptArray

hasHoles

public boolean hasHoles(com.oracle.truffle.api.object.DynamicObject object)

Specified by:

hasHoles in class ScriptArray

removeRangeImpl

public ScriptArray removeRangeImpl(com.oracle.truffle.api.object.DynamicObject 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(com.oracle.truffle.api.object.DynamicObject object,
                                long atOffset,
                                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

atOffset - starting offset position

size - size of the inserted empty array

Returns:

a ScriptArray instance with the new size

isSealed

public boolean isSealed()

Overrides:

isSealed in class ScriptArray

isFrozen

public boolean isFrozen()

Overrides:

isFrozen in class ScriptArray

isLengthNotWritable

public boolean isLengthNotWritable()

Overrides:

isLengthNotWritable in class ScriptArray

seal

public ScriptArray seal()

Specified by:

seal in class ScriptArray

freeze

public ScriptArray freeze()

Specified by:

freeze in class ScriptArray

setLengthNotWritable

public ScriptArray setLengthNotWritable()

Specified by:

setLengthNotWritable in class ScriptArray

preventExtensions

public ScriptArray preventExtensions()

Specified by:

preventExtensions in class ScriptArray

isDirect

public final boolean isDirect()

isInterop

public final boolean isInterop()

hasOffset

public final boolean hasOffset()

getBufferElement

public abstract Object getBufferElement(Object buffer,
                                        int index,
                                        boolean littleEndian,
                                        com.oracle.truffle.api.interop.InteropLibrary interop)

setBufferElement

public abstract void setBufferElement(Object buffer,
                                      int index,
                                      boolean littleEndian,
                                      Object value,
                                      com.oracle.truffle.api.interop.InteropLibrary interop)

factories

public static TypedArrayFactory[] factories()

factories

public static TypedArrayFactory[] factories(JSContext context)

unsupportedBufferAccess

protected static JSException unsupportedBufferAccess(Object buffer,
                                                     com.oracle.truffle.api.interop.UnsupportedMessageException e)