org.jikesrvm.classloader

Class RVMArray

java.lang.Object

org.jikesrvm.classloader.AnnotatedElement

org.jikesrvm.classloader.RVMType

org.jikesrvm.classloader.RVMArray

All Implemented Interfaces:

AnnotatedElement

public final class RVMArray
extends RVMType

Description of a java "array" type.

This description is not read from a ".class" file, but rather is manufactured by the VM as execution proceeds.

See Also:

RVMType, RVMClass, Primitive, UnboxedType

Field Summary

Fields

Modifier and Type	Field and Description
private boolean	acyclic Reference Count GC: is this type acyclic?
private int	alignment The desired alignment for instances of this type.
static RVMArray	BooleanArray
static RVMArray	ByteArray
static RVMArray	CharArray
static RVMArray	DoubleArray
private RVMType	elementType The RVMType object for elements of this array type.
static RVMArray	FloatArray
private boolean	inBootImage Is this array type in the bootimage?
private RVMType	innermostElementType The RVMType object for the innermost element of this array type.
private int	innermostElementTypeDimension The dimension of the innermost element of this array type.
static RVMArray	IntArray
static RVMArray	JavaLangObjectArray
private int	logElementSize The log of the element size for this array type.
static RVMArray	LongArray
static RVMArray	ShortArray
private byte	state current class-loading stage (loaded, resolved or initialized)
private TIB	typeInformationBlock The TIB for this type, created when the array is resolved.

Fields inherited from class org.jikesrvm.classloader.RVMType

AddressArrayType, AddressType, BooleanType, ByteType, CharType, CodeArrayType, CodeType, depth, dimension, doesImplement, DoubleType, emptyVMClass, emptyVMField, emptyVMMethod, ExtentArrayType, ExtentType, FloatType, FunctionTableType, id, IMTType, IntType, ITableArrayType, ITableType, JavaIoSerializableType, JavaLangClassType, JavaLangCloneableType, JavaLangObjectArrayType, JavaLangObjectType, JavaLangRefReferenceReferenceField, JavaLangRefReferenceType, JavaLangStringType, JavaLangThrowableType, LinkageTripletTableType, LongType, MagicType, NOREFS_OFFSET_ARRAY, ObjectReferenceArrayType, ObjectReferenceType, OffsetArrayType, OffsetType, REFARRAY_OFFSET_ARRAY, referenceOffsets, ShortType, superclassIds, tibOffset, TIBType, typeRef, VoidType, WordArrayType, WordType

Fields inherited from class org.jikesrvm.classloader.AnnotatedElement

declaredAnnotationDatas

Constructor Summary

Constructors

Constructor and Description
RVMArray(TypeReference typeRef, RVMType elementType)

Method Summary

Modifier and Type	Method and Description
void	allBootImageTypesResolved() This method is only called by the bootimage writer.
static void	arraycopy(boolean[] src, int srcIdx, boolean[] dst, int dstIdx, int len) Perform an array copy for arrays of booleans.
static void	arraycopy(byte[] src, int srcIdx, byte[] dst, int dstIdx, int len) Perform an array copy for arrays of bytes.
static void	arraycopy(char[] src, int srcIdx, char[] dst, int dstIdx, int len) Perform an array copy for arrays of chars.
static void	arraycopy(double[] src, int srcIdx, double[] dst, int dstIdx, int len) Perform an array copy for arrays of doubles.
static void	arraycopy(float[] src, int srcIdx, float[] dst, int dstIdx, int len) Perform an array copy for arrays of floats.
static void	arraycopy(int[] src, int srcIdx, int[] dst, int dstIdx, int len) Perform an array copy for arrays of ints.
static void	arraycopy(long[] src, int srcIdx, long[] dst, int dstIdx, int len) Perform an array copy for arrays of longs.
static void	arraycopy(Object[] src, int srcIdx, Object[] dst, int dstIdx, int len) Perform an array copy for arrays of objects.
static void	arraycopy(short[] src, int srcIdx, short[] dst, int dstIdx, int len) Perform an array copy for arrays of shorts.
private static void	arraycopyNoCheckcast(Object[] src, int srcIdx, Object[] dst, int dstIdx, int len) Perform an array copy for arrays of objects where the possibility of an ArrayStoreException being thrown does not exist.
private static void	arraycopyPiecemeal(boolean[] src, int srcIdx, boolean[] dst, int dstIdx, int len) Perform element-by-element arraycopy for array of booleans.
private static void	arraycopyPiecemeal(byte[] src, int srcIdx, byte[] dst, int dstIdx, int len) Perform element-by-element arraycopy for array of bytes.
private static void	arraycopyPiecemeal(char[] src, int srcIdx, char[] dst, int dstIdx, int len) Perform element-by-element arraycopy for array of chars.
private static void	arraycopyPiecemeal(double[] src, int srcIdx, double[] dst, int dstIdx, int len) Perform element-by-element arraycopy for array of doubles.
private static void	arraycopyPiecemeal(float[] src, int srcIdx, float[] dst, int dstIdx, int len) Perform element-by-element arraycopy for array of floats.
private static void	arraycopyPiecemeal(int[] src, int srcIdx, int[] dst, int dstIdx, int len) Perform element-by-element arraycopy for array of ints.
private static void	arraycopyPiecemeal(long[] src, int srcIdx, long[] dst, int dstIdx, int len) Perform element-by-element arraycopy for array of longs.
private static void	arraycopyPiecemeal(Object[] src, int srcIdx, Object[] dst, int dstIdx, int len) Perform an array copy for arrays of objects where the possibility of an ArrayStoreException being thrown exists.
private static void	arraycopyPiecemeal(short[] src, int srcIdx, short[] dst, int dstIdx, int len) Perform element-by-element arraycopy for array of shorts.
private static void	arraycopyPiecemealNoCheckcast(Object[] src, Object[] dst, int len, Offset srcOffset, Offset dstOffset, int bytes) Perform element-by-element arraycopy for array of objects without performing checkcast.
private int	computeLogElementSize() Calculate the size, in bytes, of an array element, log base 2.
private static void	failWithIndexOutOfBoundsException()
int	getAlignment()
int	getDimensionality() Number of [ in descriptor for arrays
RVMType	getElementType()
RVMType	getInnermostElementType()
RVMField[]	getInstanceFields() Non-static fields of this array type.
int	getInstanceSize(int numelts) Total size, in bytes, of an instance of this array type (including object header).
int	getLogElementSize() Size, in bytes, of an array element, log base 2.
int	getMemoryBytes()
static RVMArray	getPrimitiveArrayType(int atype) Get description of specified primitive array.
int	getStackWords() Space required when this type is stored on the stack (or as a field), in words.
RVMField[]	getStaticFields() Static fields of this array type.
RVMMethod[]	getStaticMethods() Statically dispatched methods of this array type.
Offset	getThinLockOffset() Get the offset in instances of this type assigned to the thin lock word.
int	getTypeDepth() get number of superclasses to Object 0 java.lang.Object, Primitive, and Classes that are interfaces 1 for RVMArrays and classes that extend Object directly
TIB	getTypeInformationBlock() Runtime type information for this array type.
RVMMethod[]	getVirtualMethods() Virtually dispatched methods of this array type.
boolean	hasFinalizer()
void	initialize() Initialization is a no-op (arrays have no <clinit> method).
void	instantiate() Instantiate an array.
boolean	isAcyclicReference() Reference Count GC: Is a reference of this type contained in another object inherently acyclic (without cycles)?
boolean	isArrayType() Is this an instance of RVMArray?
boolean	isClassType() Is this is an instance of RVMClass?
boolean	isInBootImage() Is this class part of the virtual machine's boot image?
boolean	isInitialized() Initialization status.
boolean	isInstantiated() Instantiation status.
boolean	isPrimitiveType() Is this a primitive type?
boolean	isReferenceType() Is this a reference type?
boolean	isResolved() Resolution status.
boolean	isUnboxedType() Is this an unboxed type?
void	markAsBootImageClass() Only intended to be used by the BootImageWriter
private void	publishResolved(TIB allocatedTib, short[] superclassIds, int[] doesImplement) Atomically initialize the important parts of the TIB and let the world know this type is resolved.
void	resolve() Resolve an array.
String	toString() Name - something like "[I" or "[Ljava.lang.String;"

Methods inherited from class org.jikesrvm.classloader.RVMType

asArray, asClass, asPrimitive, asUnboxedType, createClassForType, findVirtualMethod, getArrayTypeForElementType, getClassForType, getClassLoader, getDescriptor, getDesiredAssertionStatus, getDoesImplement, getId, getMMAllocator, getReferenceOffsets, getResolvedClassForType, getSuperclassIds, getTIBMethodAtSlot, getTibOffset, getType, getTypeRef, hashCode, isAssignableFrom, isBooleanType, isByteType, isCharType, isDoubleType, isFloatType, isIntLikeType, isIntType, isJavaLangObjectType, isJavaLangStringType, isJavaLangThrowableType, isLongType, isNonMoving, isShortType, isVoidType, numTypes, setMMAllocator, setSpecializedMethod, updateArrayMethods

Methods inherited from class org.jikesrvm.classloader.AnnotatedElement

getAnnotation, getAnnotations, getAnnotationsInternal, getDeclaredAnnotations, getDeclaredAnnotationsInternal, hasAnnotations, hasBaselineNoRegistersAnnotation, hasBaselineSaveLSRegistersAnnotation, hasInlineAnnotation, hasInterruptibleAnnotation, hasLogicallyUninterruptibleAnnotation, hasNoBoundsCheckAnnotation, hasNoCheckStoreAnnotation, hasNoEscapesAnnotation, hasNoInlineAnnotation, hasNonMovingAllocationAnnotation, hasNonMovingAnnotation, hasNoNullCheckAnnotation, hasNoOptCompileAnnotation, hasPreemptibleAnnotation, hasPureAnnotation, hasRuntimeFinalAnnotation, hasRuntimePureAnnotation, hasUninterruptibleAnnotation, hasUninterruptibleNoWarnAnnotation, hasUnpreemptibleAnnotation, hasUnpreemptibleNoWarnAnnotation, hasUntracedAnnotation, isAnnotationDeclared, isAnnotationPresent, readAnnotations, toAnnotations

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.reflect.AnnotatedElement

getAnnotationsByType, getDeclaredAnnotation, getDeclaredAnnotationsByType

Field Detail

BooleanArray

public static final RVMArray BooleanArray

ByteArray

public static final RVMArray ByteArray

CharArray

public static final RVMArray CharArray

ShortArray

public static final RVMArray ShortArray

IntArray

public static final RVMArray IntArray

LongArray

public static final RVMArray LongArray

FloatArray

public static final RVMArray FloatArray

DoubleArray

public static final RVMArray DoubleArray

JavaLangObjectArray

public static final RVMArray JavaLangObjectArray

elementType

private final RVMType elementType

The RVMType object for elements of this array type.

logElementSize

private final int logElementSize

The log of the element size for this array type.

innermostElementType

private final RVMType innermostElementType

The RVMType object for the innermost element of this array type.

innermostElementTypeDimension

private final int innermostElementTypeDimension

The dimension of the innermost element of this array type.

alignment

private final int alignment

The desired alignment for instances of this type. Cached rather than computed because this is a frequently asked question

acyclic

private final boolean acyclic

Reference Count GC: is this type acyclic?

typeInformationBlock

private TIB typeInformationBlock

The TIB for this type, created when the array is resolved.

state

private byte state

current class-loading stage (loaded, resolved or initialized)

inBootImage

private boolean inBootImage

Is this array type in the bootimage?

Constructor Detail

RVMArray

RVMArray(TypeReference typeRef,
         RVMType elementType)

Method Detail

toString

public String toString()

Name - something like "[I" or "[Ljava.lang.String;"

Overrides:

toString in class Object

getStackWords

public int getStackWords()

Description copied from class: RVMType

Space required when this type is stored on the stack (or as a field), in words. Ie. 0, 1, or 2 words:

• reference types (classes and arrays) require 1 word
• void types require 0 words
• long and double types require 2 words
• all other primitive types require 1 word

Specified by:

getStackWords in class RVMType

Returns:

1

getMemoryBytes

public int getMemoryBytes()

Specified by:

getMemoryBytes in class RVMType

Returns:

number of bytes in memory required to represent the type

getElementType

public RVMType getElementType()

Returns:

element type.

getInnermostElementType

public RVMType getInnermostElementType()

Returns:

innermost element type

getAlignment

public int getAlignment()

Returns:

alignment for instances of this array type

getLogElementSize

public int getLogElementSize()

Size, in bytes, of an array element, log base 2.

Returns:

log base 2 of array element size

computeLogElementSize

private int computeLogElementSize()

Calculate the size, in bytes, of an array element, log base 2.

Returns:

log base 2 of array element size

getInstanceSize

public int getInstanceSize(int numelts)

Total size, in bytes, of an instance of this array type (including object header).

Parameters:

numelts - number of array elements in the instance

Returns:

size in bytes

hasFinalizer

public boolean hasFinalizer()

Specified by:

hasFinalizer in class RVMType

Returns:

false

getStaticFields

public RVMField[] getStaticFields()

Static fields of this array type.

Specified by:

getStaticFields in class RVMType

getInstanceFields

public RVMField[] getInstanceFields()

Non-static fields of this array type.

Specified by:

getInstanceFields in class RVMType

Returns:

non-static fields of this class/array type (composed with supertypes, if any).

getStaticMethods

public RVMMethod[] getStaticMethods()

Statically dispatched methods of this array type.

Specified by:

getStaticMethods in class RVMType

getVirtualMethods

public RVMMethod[] getVirtualMethods()

Virtually dispatched methods of this array type.

Specified by:

getVirtualMethods in class RVMType

Returns:

virtually dispatched methods of this class/array type (composed with supertypes, if any).

getTypeInformationBlock

public TIB getTypeInformationBlock()

Runtime type information for this array type.

Specified by:

getTypeInformationBlock in class RVMType

Returns:

runtime type information for this class/array type.

getTypeDepth

public int getTypeDepth()

Description copied from class: RVMType

get number of superclasses to Object

• 0 java.lang.Object, Primitive, and Classes that are interfaces
• 1 for RVMArrays and classes that extend Object directly

Specified by:

getTypeDepth in class RVMType

Returns:

1

isAcyclicReference

public boolean isAcyclicReference()

Description copied from class: RVMType

Reference Count GC: Is a reference of this type contained in another object inherently acyclic (without cycles)?

Specified by:

isAcyclicReference in class RVMType

Returns:

true if the reference is acyclic

getDimensionality

public int getDimensionality()

Number of [ in descriptor for arrays

Specified by:

getDimensionality in class RVMType

Returns:

dimensionality of the type (see above)

isResolved

public boolean isResolved()

Description copied from class: RVMType

Resolution status.

If the class/array has been "resolved", then size and offset information is available by which the compiler can generate code to access this class/array's fields/methods via direct loads/stores/calls (rather than generating code to access fields/methods symbolically, via dynamic linking stubs).

Primitives are always treated as "resolved".

Specified by:

isResolved in class RVMType

Returns:

true when the class has been resolved

isInstantiated

public boolean isInstantiated()

Description copied from class: RVMType

Instantiation status.

If the class/array has been "instantiated", then all its methods have been compiled and its type information block has been placed in the JTOC.

Primitives are always treated as "instantiated".

Specified by:

isInstantiated in class RVMType

Returns:

true when the class has been instantiated

isInitialized

public boolean isInitialized()

Description copied from class: RVMType

Initialization status.

If the class has been "initialized", then its <clinit> method has been executed. Arrays have no <clinit> methods so they become "initialized" immediately upon "instantiation".

Primitives are always treated as "initialized".

Specified by:

isInitialized in class RVMType

Returns:

true when the class has been initialized

markAsBootImageClass

public void markAsBootImageClass()

Description copied from class: RVMType

Only intended to be used by the BootImageWriter

Specified by:

markAsBootImageClass in class RVMType

isInBootImage

public boolean isInBootImage()

Description copied from class: RVMType

Is this class part of the virtual machine's boot image?

Specified by:

isInBootImage in class RVMType

Returns:

true if the class is in the bootimage

getThinLockOffset

public Offset getThinLockOffset()

Get the offset in instances of this type assigned to the thin lock word.

Specified by:

getThinLockOffset in class RVMType

Returns:

the offset in instances of this type assigned to the thin lock word. Offset.max() if instances of this type do not have thin lock words.

isClassType

public boolean isClassType()

Description copied from class: RVMType

Is this is an instance of RVMClass?

Specified by:

isClassType in class RVMType

Returns:

false

isArrayType

public boolean isArrayType()

Description copied from class: RVMType

Is this an instance of RVMArray?

Specified by:

isArrayType in class RVMType

Returns:

true

isPrimitiveType

public boolean isPrimitiveType()

Description copied from class: RVMType

Is this a primitive type?

Specified by:

isPrimitiveType in class RVMType

Returns:

false

isReferenceType

public boolean isReferenceType()

Description copied from class: RVMType

Is this a reference type?

Specified by:

isReferenceType in class RVMType

Returns:

true

isUnboxedType

public boolean isUnboxedType()

Description copied from class: RVMType

Is this an unboxed type?

Specified by:

isUnboxedType in class RVMType

Returns:

false

resolve

public void resolve()

Resolve an array. Also forces the resolution of the element type.

Specified by:

resolve in class RVMType

publishResolved

private void publishResolved(TIB allocatedTib,
                             short[] superclassIds,
                             int[] doesImplement)

Atomically initialize the important parts of the TIB and let the world know this type is resolved.

Parameters:

allocatedTib - The TIB that has been allocated for this type

superclassIds - The calculated superclass ids array

doesImplement - The calculated does implement array

allBootImageTypesResolved

public void allBootImageTypesResolved()

Description copied from class: RVMType

This method is only called by the bootimage writer. It is called after RVMType.resolve() has been called on all bootimage types but before RVMType.instantiate() has been called on any bootimage type. This provides a hook to compute various summaries that cannot be computed before types are resolved.

Specified by:

allBootImageTypesResolved in class RVMType

instantiate

public void instantiate()

Instantiate an array. Main result is to copy the virtual methods from JavaLangObject's TIB.

Specified by:

instantiate in class RVMType

initialize

public void initialize()

Initialization is a no-op (arrays have no <clinit> method).

Specified by:

initialize in class RVMType

getPrimitiveArrayType

public static RVMArray getPrimitiveArrayType(int atype)

Get description of specified primitive array.

Parameters:

atype - array type number (see "newarray" bytecode description in Java VM Specification)

Returns:

array description

arraycopy

public static void arraycopy(byte[] src,
                             int srcIdx,
                             byte[] dst,
                             int dstIdx,
                             int len)

Perform an array copy for arrays of bytes.

Parameters:

src - The source array

srcIdx - The starting source index

dst - The destination array

dstIdx - The starting destination index

len - The number of array elements to be copied

arraycopyPiecemeal

private static void arraycopyPiecemeal(byte[] src,
                                       int srcIdx,
                                       byte[] dst,
                                       int dstIdx,
                                       int len)

Perform element-by-element arraycopy for array of bytes. Used when bulk copy is not possible.

Parameters:

src - The source array

srcIdx - The starting source index

dst - The destination array

dstIdx - The starting destination index

len - The number of array elements to be copied

arraycopy

public static void arraycopy(boolean[] src,
                             int srcIdx,
                             boolean[] dst,
                             int dstIdx,
                             int len)

Perform an array copy for arrays of booleans.

Parameters:

src - The source array

srcIdx - The starting source index

dst - The destination array

dstIdx - The starting destination index

len - The number of array elements to be copied

arraycopyPiecemeal

private static void arraycopyPiecemeal(boolean[] src,
                                       int srcIdx,
                                       boolean[] dst,
                                       int dstIdx,
                                       int len)

Perform element-by-element arraycopy for array of booleans. Used when bulk copy is not possible.

Parameters:

src - The source array

srcIdx - The starting source index

dst - The destination array

dstIdx - The starting destination index

len - The number of array elements to be copied

arraycopy

public static void arraycopy(short[] src,
                             int srcIdx,
                             short[] dst,
                             int dstIdx,
                             int len)

Perform an array copy for arrays of shorts.

Parameters:

src - The source array

srcIdx - The starting source index

dst - The destination array

dstIdx - The starting destination index

len - The number of array elements to be copied

arraycopyPiecemeal

private static void arraycopyPiecemeal(short[] src,
                                       int srcIdx,
                                       short[] dst,
                                       int dstIdx,
                                       int len)

Perform element-by-element arraycopy for array of shorts. Used when bulk copy is not possible.

Parameters:

src - The source array

srcIdx - The starting source index

dst - The destination array

dstIdx - The starting destination index

len - The number of array elements to be copied

arraycopy

public static void arraycopy(char[] src,
                             int srcIdx,
                             char[] dst,
                             int dstIdx,
                             int len)

Perform an array copy for arrays of chars.

Parameters:

src - The source array

srcIdx - The starting source index

dst - The destination array

dstIdx - The starting destination index

len - The number of array elements to be copied

arraycopyPiecemeal

private static void arraycopyPiecemeal(char[] src,
                                       int srcIdx,
                                       char[] dst,
                                       int dstIdx,
                                       int len)

Perform element-by-element arraycopy for array of chars. Used when bulk copy is not possible.

Parameters:

src - The source array

srcIdx - The starting source index

dst - The destination array

dstIdx - The starting destination index

len - The number of array elements to be copied

arraycopy

public static void arraycopy(int[] src,
                             int srcIdx,
                             int[] dst,
                             int dstIdx,
                             int len)

Perform an array copy for arrays of ints.

Parameters:

src - The source array

srcIdx - The starting source index

dst - The destination array

dstIdx - The starting destination index

len - The number of array elements to be copied

arraycopyPiecemeal

private static void arraycopyPiecemeal(int[] src,
                                       int srcIdx,
                                       int[] dst,
                                       int dstIdx,
                                       int len)

Perform element-by-element arraycopy for array of ints. Used when bulk copy is not possible.

Parameters:

src - The source array

srcIdx - The starting source index

dst - The destination array

dstIdx - The starting destination index

len - The number of array elements to be copied

arraycopy

public static void arraycopy(float[] src,
                             int srcIdx,
                             float[] dst,
                             int dstIdx,
                             int len)

Perform an array copy for arrays of floats.

Parameters:

src - The source array

srcIdx - The starting source index

dst - The destination array

dstIdx - The starting destination index

len - The number of array elements to be copied

arraycopyPiecemeal

private static void arraycopyPiecemeal(float[] src,
                                       int srcIdx,
                                       float[] dst,
                                       int dstIdx,
                                       int len)

Perform element-by-element arraycopy for array of floats. Used when bulk copy is not possible.

Parameters:

src - The source array

srcIdx - The starting source index

dst - The destination array

dstIdx - The starting destination index

len - The number of array elements to be copied

arraycopy

public static void arraycopy(long[] src,
                             int srcIdx,
                             long[] dst,
                             int dstIdx,
                             int len)

Perform an array copy for arrays of longs.

Parameters:

src - The source array

srcIdx - The starting source index

dst - The destination array

dstIdx - The starting destination index

len - The number of array elements to be copied

arraycopyPiecemeal

private static void arraycopyPiecemeal(long[] src,
                                       int srcIdx,
                                       long[] dst,
                                       int dstIdx,
                                       int len)

Perform element-by-element arraycopy for array of longs. Used when bulk copy is not possible.

Parameters:

src - The source array

srcIdx - The starting source index

dst - The destination array

dstIdx - The starting destination index

len - The number of array elements to be copied

arraycopy

public static void arraycopy(double[] src,
                             int srcIdx,
                             double[] dst,
                             int dstIdx,
                             int len)

Perform an array copy for arrays of doubles.

Parameters:

src - The source array

srcIdx - The starting source index

dst - The destination array

dstIdx - The starting destination index

len - The number of array elements to be copied

arraycopyPiecemeal

private static void arraycopyPiecemeal(double[] src,
                                       int srcIdx,
                                       double[] dst,
                                       int dstIdx,
                                       int len)

Perform element-by-element arraycopy for array of doubles. Used when bulk copy is not possible.

Parameters:

src - The source array

srcIdx - The starting source index

dst - The destination array

dstIdx - The starting destination index

len - The number of array elements to be copied

arraycopy

public static void arraycopy(Object[] src,
                             int srcIdx,
                             Object[] dst,
                             int dstIdx,
                             int len)

Perform an array copy for arrays of objects. This code must ensure that write barriers are invoked as if the copy were performed element-by-element.

Parameters:

src - The source array

srcIdx - The starting source index

dst - The destination array

dstIdx - The starting destination index

len - The number of array elements to be copied

arraycopyNoCheckcast

private static void arraycopyNoCheckcast(Object[] src,
                                         int srcIdx,
                                         Object[] dst,
                                         int dstIdx,
                                         int len)

Perform an array copy for arrays of objects where the possibility of an ArrayStoreException being thrown does not exist. This may be done using direct byte copies, however, write barriers must be explicitly invoked (if required by the GC) since the write barrier associated with an explicit array store (aastore) will be bypassed.

Parameters:

src - The source array

srcIdx - The starting source index

dst - The destination array

dstIdx - The starting source index

len - The number of array elements to be copied

arraycopyPiecemealNoCheckcast

private static void arraycopyPiecemealNoCheckcast(Object[] src,
                                                  Object[] dst,
                                                  int len,
                                                  Offset srcOffset,
                                                  Offset dstOffset,
                                                  int bytes)

Perform element-by-element arraycopy for array of objects without performing checkcast. Used when bulk copy is not possible, but checkcast is still not necessary. If barriers are required they must be explicitly invoked.

Parameters:

src - The source array

dst - The destination array

len - The number of array elements to be copied

srcOffset - The starting offset in the source array

dstOffset - The starting offset in the destination array.

bytes - the number of bytes to copy

arraycopyPiecemeal

private static void arraycopyPiecemeal(Object[] src,
                                       int srcIdx,
                                       Object[] dst,
                                       int dstIdx,
                                       int len)

Perform an array copy for arrays of objects where the possibility of an ArrayStoreException being thrown exists. This must be done with element by element assignments in the correct order. Since write barriers are implicitly performed on explicit array stores, there is no need to explicitly invoke a write barrier in this code.

Parameters:

src - The source array

srcIdx - The starting source index

dst - The destination array

dstIdx - The starting destination index

len - The number of array elements to be copied

failWithIndexOutOfBoundsException

private static void failWithIndexOutOfBoundsException()