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	Description
static class	TypedArray.AbstractUint32Array
static class	TypedArray.AbstractUint8ClampedArray
static final class	TypedArray.BigInt64Array
static final class	TypedArray.BigUint64Array
static final class	TypedArray.DirectBigInt64Array
static final class	TypedArray.DirectBigUint64Array
static final class	TypedArray.DirectFloat16Array
static final class	TypedArray.DirectFloat32Array
static final class	TypedArray.DirectFloat64Array
static final class	TypedArray.DirectInt16Array
static final class	TypedArray.DirectInt32Array
static final class	TypedArray.DirectInt8Array
static final class	TypedArray.DirectUint16Array
static final class	TypedArray.DirectUint32Array
static final class	TypedArray.DirectUint8Array
static final class	TypedArray.DirectUint8ClampedArray
static enum	TypedArray.ElementType
static final class	TypedArray.Float16Array
static final class	TypedArray.Float32Array
static final class	TypedArray.Float64Array
static final class	TypedArray.Int16Array
static final class	TypedArray.Int32Array
static final class	TypedArray.Int8Array
static class	TypedArray.InteropBigInt64Array
static class	TypedArray.InteropBigIntArray
static final class	TypedArray.InteropBigUint64Array
static final class	TypedArray.InteropFloat16Array
static final class	TypedArray.InteropFloat32Array
static final class	TypedArray.InteropFloat64Array
static class	TypedArray.InteropInt16Array
static final class	TypedArray.InteropInt32Array
static class	TypedArray.InteropInt8Array
static class	TypedArray.InteropOneByteIntArray
static class	TypedArray.InteropTwoByteIntArray
static final class	TypedArray.InteropUint16Array
static final class	TypedArray.InteropUint32Array
static final class	TypedArray.InteropUint8Array
static final class	TypedArray.InteropUint8ClampedArray
static class	TypedArray.TypedBigIntArray
static class	TypedArray.TypedFloatArray
static class	TypedArray.TypedIntArray
static final class	TypedArray.Uint16Array
static final class	TypedArray.Uint32Array
static final class	TypedArray.Uint8Array
static final class	TypedArray.Uint8ClampedArray

Nested classes/interfaces inherited from class ScriptArray

ScriptArray.CreateWritableProfileAccess, ScriptArray.DefaultIterator, ScriptArray.SetLengthProfileAccess

Field Summary

Fields

Modifier and Type	Field	Description
static final byte	BUFFER_TYPE_ARRAY
static final byte	BUFFER_TYPE_DIRECT
static final byte	BUFFER_TYPE_INTEROP
static final byte	BUFFER_TYPE_SHARED

Fields inherited from class ScriptArray

EMPTY_OBJECT_ARRAY

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	TypedArray(TypedArrayFactory factory, boolean offset, boolean fixedLength, byte bufferType)

Method Summary

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

Methods inherited from class ScriptArray

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

Methods inherited from class Object

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

Field Details

BUFFER_TYPE_ARRAY

public static final byte BUFFER_TYPE_ARRAY

See Also:

• Constant Field Values

BUFFER_TYPE_DIRECT

public static final byte BUFFER_TYPE_DIRECT

See Also:

• Constant Field Values

BUFFER_TYPE_SHARED

public static final byte BUFFER_TYPE_SHARED

See Also:

• Constant Field Values

BUFFER_TYPE_INTEROP

public static final byte BUFFER_TYPE_INTEROP

See Also:

• Constant Field Values

Constructor Details

TypedArray

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

Method Details

length

public final long length(JSDynamicObject object)

Specified by:

length in class ScriptArray

lengthInt

public final int lengthInt(JSDynamicObject object)

Specified by:

lengthInt in class ScriptArray

setLengthImpl

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

Specified by:

setLengthImpl in class ScriptArray

firstElementIndex

public final long firstElementIndex(JSDynamicObject object)

Description copied from class: ScriptArray

First element index (inclusive).

Specified by:

firstElementIndex in class ScriptArray

lastElementIndex

public final long lastElementIndex(JSDynamicObject object)

Description copied from class: ScriptArray

Last element index (inclusive).

Specified by:

lastElementIndex in class ScriptArray

nextElementIndex

public final long nextElementIndex(JSDynamicObject 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(JSDynamicObject 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

deleteElementImpl

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

Specified by:

deleteElementImpl in class ScriptArray

hasElement

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

getDirectByteBuffer

protected static ByteBuffer getDirectByteBuffer(JSArrayBufferObject buffer)

Get ByteBuffer from ArrayBuffer with unspecified byte order.

getByteArray

protected static byte[] getByteArray(JSArrayBufferObject buffer)

Get byte[] from ArrayBuffer.

getBufferFromTypedArray

public static JSArrayBufferObject getBufferFromTypedArray(JSDynamicObject typedArray)

Get ArrayBuffer from TypedArray.

getOffset

public final int getOffset(JSDynamicObject object)

getFactory

public final TypedArrayFactory getFactory()

bytesPerElement

public final int bytesPerElement()

bytesPerElementShift

public final byte bytesPerElementShift()

getName

public final com.oracle.truffle.api.strings.TruffleString getName()

isHolesType

public boolean isHolesType()

Description copied from class: ScriptArray

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

Overrides:

isHolesType in class ScriptArray

hasHoles

public boolean hasHoles(JSDynamicObject object)

Description copied from class: ScriptArray

Returns true when this array actually has holes between ScriptArray.firstElementIndex(JSDynamicObject) and ScriptArray.lastElementIndex(JSDynamicObject). Implies ScriptArray.isHolesType().

Specified by:

hasHoles in class ScriptArray

See Also:

• ScriptArray.hasHolesOrUnused(JSDynamicObject)

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

Parameters:

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()

getBufferType

public final byte getBufferType()

hasOffset

public final boolean hasOffset()

getElementType

public abstract TypedArray.ElementType getElementType()

getBufferElement

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

setBufferElement

public abstract void setBufferElement(JSArrayBufferObject 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)