com.sun.squawk
Class NativeUnsafe

java.lang.Object
  com.sun.squawk.NativeUnsafe

public final class NativeUnsafe
extends Object

A collection of methods for performing peek and poke operations on memory addresses.

Only the public methods of this class which do not override any of the methods in java.lang.Object will be available in a non-hosted environment. The translator replaces any calls to these methods to native method calls.

Author:

Nik Shaylor, Doug Simon

Method Summary

static char	charAt(String str, int index) Gets character from a string.
static void	clearObject(Object base, int offset) Clears a pointer value in memory.
static void	copyMemory(byte[] buffer, int memoryOffset, int bufferOffset, int length) Copies a range of memory into a buffer.
static void	copyTypes(Address src, Address dst, int length) Block copies the types recorded for a range of memory to another range of memory.
static Address	getAddress(Object base, int offset)
static int	getAsByte(Object base, int offset)
static int	getAsInt(Object base, int offset)
static int	getAsShort(Object base, int offset)
static UWord	getAsUWord(Object base, int offset)
static int	getByte(Object base, int offset)
static int	getChar(Object base, int offset)
static int	getInt(Object base, int offset)
static long	getLong(Object base, int offset)
static long	getLongAtWord(Object base, int offset)
static Object	getObject(Object base, int offset)
static int	getShort(Object base, int offset)
static byte	getType(Address ea) Gets the type of a value at a given address.
static UWord	getUWord(Object base, int offset)
static void	initialize(byte[] buffer, BitSet oopMap, boolean append) Initialize or appends to the contents of memory.
static void	setAddress(Object base, int offset, Object value)
static void	setArrayTypes(Address ea, byte componentType, int componentSize, int length) Sets the type of each value in an array.
static void	setByte(Object base, int offset, int value)
static void	setChar(Object base, int offset, int value)
static void	setInt(Object base, int offset, int value)
static void	setLong(Object base, int offset, long value)
static void	setLongAtWord(Object base, int offset, long value)
static void	setMemorySize(int newSize) Sets the size of used/initialized memory.
static void	setObject(Object base, int offset, Object value)
static void	setShort(Object base, int offset, int value)
static void	setType(Address ea, byte type, int size) Sets the type of a value at a given address.
static void	setUWord(Object base, int offset, UWord value)
static void	swap(Address address, int dataSize) Swaps the endianess of a value.
static void	swap2(Address address) Swaps the endianess of a 2 byte value.
static void	swap4(Address address) Swaps the endianess of a 4 byte value.
static void	swap8(Address address) Swaps the endianess of a 8 byte value.

Methods inherited from class java.lang.Object

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

Method Detail

setByte

public static void setByte(Object base,
                           int offset,
                           int value)
                    throws com.sun.squawk.pragma.NativePragma

Throws:

com.sun.squawk.pragma.NativePragma

See Also:

Unsafe.setByte(java.lang.Object, int, int)

setShort

public static void setShort(Object base,
                            int offset,
                            int value)
                     throws com.sun.squawk.pragma.NativePragma

Throws:

com.sun.squawk.pragma.NativePragma

See Also:

Unsafe.setShort(java.lang.Object, int, int)

setChar

public static void setChar(Object base,
                           int offset,
                           int value)
                    throws com.sun.squawk.pragma.NativePragma

Throws:

com.sun.squawk.pragma.NativePragma

See Also:

Unsafe.setChar(java.lang.Object, int, int)

setInt

public static void setInt(Object base,
                          int offset,
                          int value)
                   throws com.sun.squawk.pragma.NativePragma

Throws:

com.sun.squawk.pragma.NativePragma

See Also:

Unsafe.setInt(java.lang.Object, int, int)

setUWord

public static void setUWord(Object base,
                            int offset,
                            UWord value)
                     throws com.sun.squawk.pragma.NativePragma

Throws:

com.sun.squawk.pragma.NativePragma

See Also:

Unsafe.setUWord(java.lang.Object, int, com.sun.squawk.UWord)

setLong

public static void setLong(Object base,
                           int offset,
                           long value)
                    throws com.sun.squawk.pragma.NativePragma

Throws:

com.sun.squawk.pragma.NativePragma

See Also:

Unsafe.setLong(java.lang.Object, int, long)

setLongAtWord

public static void setLongAtWord(Object base,
                                 int offset,
                                 long value)
                          throws com.sun.squawk.pragma.NativePragma

Throws:

com.sun.squawk.pragma.NativePragma

See Also:

Unsafe.setLongAtWord(java.lang.Object, int, long)

setAddress

public static void setAddress(Object base,
                              int offset,
                              Object value)
                       throws com.sun.squawk.pragma.NativePragma

Throws:

com.sun.squawk.pragma.NativePragma

See Also:

Unsafe.setAddress(java.lang.Object, int, java.lang.Object)

setObject

public static void setObject(Object base,
                             int offset,
                             Object value)
                      throws com.sun.squawk.pragma.NativePragma

Throws:

com.sun.squawk.pragma.NativePragma

See Also:

Unsafe.setObject(java.lang.Object, int, java.lang.Object)

setType

public static void setType(Address ea,
                           byte type,
                           int size)
                    throws com.sun.squawk.pragma.NativePragma

Sets the type of a value at a given address. This operation is a nop when VM.usingTypeMap() returns false.

Parameters:

ea - the address of the value

type - the type of the value

size - the size (in bytes) of the value

Throws:

com.sun.squawk.pragma.NativePragma

setArrayTypes

public static void setArrayTypes(Address ea,
                                 byte componentType,
                                 int componentSize,
                                 int length)
                          throws com.sun.squawk.pragma.NativePragma

Sets the type of each value in an array. This operation is a nop when VM.usingTypeMap() returns false.

Parameters:

ea - the address of an array

componentType - the component type of the array

componentSize - the size (in bytes) of componentType

length - the length of the array

Throws:

com.sun.squawk.pragma.NativePragma

getType

public static byte getType(Address ea)
                    throws com.sun.squawk.pragma.NativePragma

Gets the type of a value at a given address. This operation is a nop when VM.usingTypeMap() returns false.

Parameters:

ea - the address to query

Returns:

the type of the value at ea

Throws:

com.sun.squawk.pragma.NativePragma

copyTypes

public static void copyTypes(Address src,
                             Address dst,
                             int length)
                      throws com.sun.squawk.pragma.NativePragma

Block copies the types recorded for a range of memory to another range of memory.

Parameters:

src - the start address of the source range

dst - the start address of the destination range

length - the length (in bytes) of the range

Throws:

com.sun.squawk.pragma.NativePragma

getByte

public static int getByte(Object base,
                          int offset)
                   throws com.sun.squawk.pragma.NativePragma

Throws:

com.sun.squawk.pragma.NativePragma

See Also:

Unsafe.getByte(java.lang.Object, int)

getShort

public static int getShort(Object base,
                           int offset)
                    throws com.sun.squawk.pragma.NativePragma

Throws:

com.sun.squawk.pragma.NativePragma

See Also:

Unsafe.getShort(java.lang.Object, int)

getChar

public static int getChar(Object base,
                          int offset)
                   throws com.sun.squawk.pragma.NativePragma

Throws:

com.sun.squawk.pragma.NativePragma

See Also:

Unsafe.getChar(java.lang.Object, int)

getInt

public static int getInt(Object base,
                         int offset)
                  throws com.sun.squawk.pragma.NativePragma

Throws:

com.sun.squawk.pragma.NativePragma

See Also:

Unsafe.getInt(java.lang.Object, int)

getUWord

public static UWord getUWord(Object base,
                             int offset)
                      throws com.sun.squawk.pragma.NativePragma

Throws:

com.sun.squawk.pragma.NativePragma

See Also:

Unsafe.getUWord(java.lang.Object, int)

getLong

public static long getLong(Object base,
                           int offset)
                    throws com.sun.squawk.pragma.NativePragma

Throws:

com.sun.squawk.pragma.NativePragma

See Also:

Unsafe.getLong(java.lang.Object, int)

getLongAtWord

public static long getLongAtWord(Object base,
                                 int offset)
                          throws com.sun.squawk.pragma.NativePragma

Throws:

com.sun.squawk.pragma.NativePragma

See Also:

Unsafe.getLongAtWord(java.lang.Object, int)

getObject

public static Object getObject(Object base,
                               int offset)
                        throws com.sun.squawk.pragma.NativePragma

Throws:

com.sun.squawk.pragma.NativePragma

See Also:

Unsafe.getObject(java.lang.Object, int)

getAddress

public static Address getAddress(Object base,
                                 int offset)
                          throws com.sun.squawk.pragma.NativePragma

Throws:

com.sun.squawk.pragma.NativePragma

See Also:

Unsafe.getAddress(java.lang.Object, int)

getAsUWord

public static UWord getAsUWord(Object base,
                               int offset)
                        throws com.sun.squawk.pragma.NativePragma

Throws:

com.sun.squawk.pragma.NativePragma

See Also:

Unsafe.getAsUWord(java.lang.Object, int)

getAsByte

public static int getAsByte(Object base,
                            int offset)
                     throws com.sun.squawk.pragma.NativePragma

Throws:

com.sun.squawk.pragma.NativePragma

See Also:

Unsafe.getAsByte(java.lang.Object, int)

getAsShort

public static int getAsShort(Object base,
                             int offset)
                      throws com.sun.squawk.pragma.NativePragma

Throws:

com.sun.squawk.pragma.NativePragma

See Also:

Unsafe.getAsShort(java.lang.Object, int)

getAsInt

public static int getAsInt(Object base,
                           int offset)
                    throws com.sun.squawk.pragma.NativePragma

Throws:

com.sun.squawk.pragma.NativePragma

See Also:

Unsafe.getAsInt(java.lang.Object, int)

charAt

public static char charAt(String str,
                          int index)
                   throws com.sun.squawk.pragma.NativePragma

Gets character from a string.

Parameters:

str - the string

index - the index to the character

Returns:

the value

Throws:

com.sun.squawk.pragma.NativePragma

swap

public static void swap(Address address,
                        int dataSize)
                 throws com.sun.squawk.pragma.NativePragma

Swaps the endianess of a value.

Parameters:

address - the address of the value

dataSize - the size (in bytes) of the value

Throws:

com.sun.squawk.pragma.NativePragma

swap2

public static void swap2(Address address)
                  throws com.sun.squawk.pragma.NativePragma

Swaps the endianess of a 2 byte value.

Parameters:

address - the address of the value

Throws:

com.sun.squawk.pragma.NativePragma

swap4

public static void swap4(Address address)
                  throws com.sun.squawk.pragma.NativePragma

Swaps the endianess of a 4 byte value.

Parameters:

address - the address of the value

Throws:

com.sun.squawk.pragma.NativePragma

swap8

public static void swap8(Address address)
                  throws com.sun.squawk.pragma.NativePragma

Swaps the endianess of a 8 byte value.

Parameters:

address - the address of the value

Throws:

com.sun.squawk.pragma.NativePragma

clearObject

public static void clearObject(Object base,
                               int offset)
                        throws com.sun.squawk.pragma.HostedPragma

Clears a pointer value in memory.

Parameters:

base - the base address

offset - the offset (in UWords) from base of the pointer to clear

Throws:

com.sun.squawk.pragma.HostedPragma

initialize

public static void initialize(byte[] buffer,
                              BitSet oopMap,
                              boolean append)
                       throws com.sun.squawk.pragma.HostedPragma

Initialize or appends to the contents of memory.

Parameters:

buffer - a buffer containing a serialized object memory relative to 0

oopMap - an oop map specifying where the pointers in the serialized object memory are

append - specifies if the memory is being appended to

Throws:

com.sun.squawk.pragma.HostedPragma

setMemorySize

public static void setMemorySize(int newSize)
                          throws com.sun.squawk.pragma.HostedPragma

Sets the size of used/initialized memory. If the new size is less than the current size, all memory locations at index newSize and greater are zeroed.

Parameters:

newSize - the new size of memory

Throws:

com.sun.squawk.pragma.HostedPragma

copyMemory

public static void copyMemory(byte[] buffer,
                              int memoryOffset,
                              int bufferOffset,
                              int length)
                       throws com.sun.squawk.pragma.HostedPragma

Copies a range of memory into a buffer.

Parameters:

buffer - the buffer to copy into

memoryOffset - the offset in memory at which to start copying from

bufferOffset - the offset in buffer at which to start copying to

length - the number of bytes to copy

Throws:

com.sun.squawk.pragma.HostedPragma