com.sun.rtsjx
Interface RawMemoryAccessImpl


public interface RawMemoryAccessImpl

Interface for the providers of get/set raw memory commands.

These methods are called only if RawMemoryAccess has detected that the parameters are valid according to standard rules:

A provider is required only if the access cannot be done by a pointer or memcpy operation or if additional checks need to be performed.


Method Summary
 byte getByte(long base, long offset)
          Gets the byte at the given offset.
 void getBytes(long base, long offset, byte[] bytes, int low, int number)
          Gets number bytes starting at the given offset and assign them to the byte array passed starting at position low.
 double getDouble(long base, long offset)
          Gets the double at the given offset.
 void getDoubles(long base, long offset, double[] doubles, int low, int number)
          Gets number double values starting at the given offset in this, and assigns them into the double array starting at position low.
 float getFloat(long base, long offset)
          Gets the float at the given offset.
 void getFloats(long base, long offset, float[] floats, int low, int number)
          Gets number float values starting at the given offset in this and assign them into the byte array starting at position low.
 int getInt(long base, long offset)
          Gets the int at the given offset.
 void getInts(long base, long offset, int[] ints, int low, int number)
          Gets number integers starting at the given offset and assign them to the int array passed starting at position low.
 long getLong(long base, long offset)
          Gets the long at the given offset.
 void getLongs(long base, long offset, long[] longs, int low, int number)
          Gets number longs starting at the given offset and assign them to the long array passed starting at position low.
 short getShort(long base, long offset)
          Gets the short at the given offset.
 void getShorts(long base, long offset, short[] shorts, int low, int number)
          Gets number shorts starting at the given offset and assign them to the short array passed starting at position low.
 void setByte(long base, long offset, byte value)
          Sets the byte at the given offset.
 void setBytes(long base, long offset, byte[] bytes, int low, int number)
          Sets number bytes starting at the given offset from the byte array passed starting at position low.
 void setDouble(long base, long offset, double value)
          Sets the double at the given offset.
 void setDoubles(long base, long offset, double[] doubles, int low, int number)
          Sets number double values starting at the given offset in this, and assigns them into the double array starting at position low.
 void setFloat(long base, long offset, float value)
          Sets the float at the given offset.
 void setFloats(long base, long offset, float[] floats, int low, int number)
          Sets number float values starting at the given offset in this from the byte array starting at position low.
 void setInt(long base, long offset, int value)
          Sets the int at the given offset.
 void setInts(long base, long offset, int[] ints, int low, int number)
          Sets number ints starting at the given offset from the int array passed starting at position low.
 void setLong(long base, long offset, long value)
          Sets the long at the given offset.
 void setLongs(long base, long offset, long[] longs, int low, int number)
          Sets number longs starting at the given offset from the long array passed starting at position low.
 void setShort(long base, long offset, short value)
          Sets the short at the given offset.
 void setShorts(long base, long offset, short[] shorts, int low, int number)
          Sets number shorts starting at the given offset from the short array passed starting at position low.
 

Method Detail

getByte

byte getByte(long base,
             long offset)
             throws javax.realtime.OffsetOutOfBoundsException,
                    javax.realtime.SizeOutOfBoundsException
Gets the byte at the given offset.

Parameters:
base - base address of the RawMemoryAccess caller
offset - The offset at which to read the byte.
Returns:
The byte read.
Throws:
javax.realtime.OffsetOutOfBoundsException - The offset is invalid.
javax.realtime.SizeOutOfBoundsException - The size is negative or extends into an invalid address range.

getBytes

void getBytes(long base,
              long offset,
              byte[] bytes,
              int low,
              int number)
              throws javax.realtime.OffsetOutOfBoundsException,
                     javax.realtime.SizeOutOfBoundsException
Gets number bytes starting at the given offset and assign them to the byte array passed starting at position low.

Parameters:
base - base address of the RawMemoryAccess caller
offset - The offset at which to start reading.
bytes - The array into which the read items are placed.
low - The offset which is the starting point in the given array for the read items to be placed.
number - The number of items to read.
Throws:
javax.realtime.OffsetOutOfBoundsException - The offset is invalid.
javax.realtime.SizeOutOfBoundsException - The size is negative or extends into an invalid address range.

getInt

int getInt(long base,
           long offset)
           throws javax.realtime.OffsetOutOfBoundsException,
                  javax.realtime.SizeOutOfBoundsException
Gets the int at the given offset.

Parameters:
base - base address of the RawMemoryAccess caller
offset - The offset at which to read the integer.
Returns:
The integer read.
Throws:
javax.realtime.OffsetOutOfBoundsException - The offset is invalid.
javax.realtime.SizeOutOfBoundsException - The size is negative or extends into an invalid address range.

getInts

void getInts(long base,
             long offset,
             int[] ints,
             int low,
             int number)
             throws javax.realtime.OffsetOutOfBoundsException,
                    javax.realtime.SizeOutOfBoundsException
Gets number integers starting at the given offset and assign them to the int array passed starting at position low.

Parameters:
base - base address of the RawMemoryAccess caller
offset - The offset at which to start reading.
ints - The array into which the read items are placed.
low - The offset which is the starting point in the given array for the read items to be placed.
number - The number of items to read.
Throws:
javax.realtime.OffsetOutOfBoundsException - The offset is invalid.
javax.realtime.SizeOutOfBoundsException - The size is negative or extends into an invalid address range.

getLong

long getLong(long base,
             long offset)
             throws javax.realtime.OffsetOutOfBoundsException,
                    javax.realtime.SizeOutOfBoundsException
Gets the long at the given offset.

Parameters:
base - base address of the RawMemoryAccess caller
offset - The offset at which to read the long.
Returns:
The long read.
Throws:
javax.realtime.OffsetOutOfBoundsException - The offset is invalid.
javax.realtime.SizeOutOfBoundsException - The size is negative or extends into an invalid address range.

getLongs

void getLongs(long base,
              long offset,
              long[] longs,
              int low,
              int number)
              throws javax.realtime.OffsetOutOfBoundsException,
                     javax.realtime.SizeOutOfBoundsException
Gets number longs starting at the given offset and assign them to the long array passed starting at position low.

Parameters:
base - base address of the RawMemoryAccess caller
offset - The offset at which to start reading.
longs - The array into which the read items are placed.
low - The offset which is the starting point in the given array for the read items to be placed.
number - The number of items to read.
Throws:
javax.realtime.OffsetOutOfBoundsException - The offset is invalid.
javax.realtime.SizeOutOfBoundsException - The size is negative or extends into an invalid address range.

getShort

short getShort(long base,
               long offset)
               throws javax.realtime.OffsetOutOfBoundsException,
                      javax.realtime.SizeOutOfBoundsException
Gets the short at the given offset.

Parameters:
base - base address of the RawMemoryAccess caller
offset - The offset at which to read the short.
Returns:
The short read.
Throws:
javax.realtime.OffsetOutOfBoundsException - The offset is invalid.
javax.realtime.SizeOutOfBoundsException - The size is negative or extends into an invalid address range.

getShorts

void getShorts(long base,
               long offset,
               short[] shorts,
               int low,
               int number)
               throws javax.realtime.OffsetOutOfBoundsException,
                      javax.realtime.SizeOutOfBoundsException
Gets number shorts starting at the given offset and assign them to the short array passed starting at position low.

Parameters:
base - base address of the RawMemoryAccess caller
offset - The offset at which to start reading.
shorts - The array into which the read items are placed.
low - The offset which is the starting point in the given array for the read items to be placed.
number - The number of items to read.
Throws:
javax.realtime.OffsetOutOfBoundsException - The offset is invalid.
javax.realtime.SizeOutOfBoundsException - The size is negative or extends into an invalid address range.

setByte

void setByte(long base,
             long offset,
             byte value)
             throws javax.realtime.OffsetOutOfBoundsException,
                    javax.realtime.SizeOutOfBoundsException
Sets the byte at the given offset.

Parameters:
base - base address of the RawMemoryAccess caller
offset - The offset at which to write the byte.
value - The byte to write.
Throws:
javax.realtime.OffsetOutOfBoundsException - The offset is invalid.
javax.realtime.SizeOutOfBoundsException - The size is negative or extends into an invalid address range.

setBytes

void setBytes(long base,
              long offset,
              byte[] bytes,
              int low,
              int number)
              throws javax.realtime.OffsetOutOfBoundsException,
                     javax.realtime.SizeOutOfBoundsException
Sets number bytes starting at the given offset from the byte array passed starting at position low.

Parameters:
base - base address of the RawMemoryAccess caller
offset - The offset at which to start writing.
bytes - The array from which the items are obtained.
low - The offset which is the starting point in the given array for the items to be obtained.
number - The number of items to write.
Throws:
javax.realtime.OffsetOutOfBoundsException - The offset is invalid.
javax.realtime.SizeOutOfBoundsException - The size is negative or extends into an invalid address range.

setInt

void setInt(long base,
            long offset,
            int value)
            throws javax.realtime.OffsetOutOfBoundsException,
                   javax.realtime.SizeOutOfBoundsException
Sets the int at the given offset.

Parameters:
base - base address of the RawMemoryAccess caller
offset - The offset at which to write the integer.
value - The integer to write.
Throws:
javax.realtime.OffsetOutOfBoundsException - The offset is invalid.
javax.realtime.SizeOutOfBoundsException - The size is negative or extends into an invalid address range.

setInts

void setInts(long base,
             long offset,
             int[] ints,
             int low,
             int number)
             throws javax.realtime.OffsetOutOfBoundsException,
                    javax.realtime.SizeOutOfBoundsException
Sets number ints starting at the given offset from the int array passed starting at position low.

Parameters:
base - base address of the RawMemoryAccess caller
offset - The offset at which to start writing.
ints - The array from which the items are obtained.
low - The offset which is the starting point in the given array for the items to be obtained.
number - The number of items to write.
Throws:
javax.realtime.OffsetOutOfBoundsException - The offset is invalid.
javax.realtime.SizeOutOfBoundsException - The size is negative or extends into an invalid address range.

setLong

void setLong(long base,
             long offset,
             long value)
             throws javax.realtime.OffsetOutOfBoundsException,
                    javax.realtime.SizeOutOfBoundsException
Sets the long at the given offset.

Parameters:
base - base address of the RawMemoryAccess caller
offset - The offset at which to write the long.
value - The long to write.
Throws:
javax.realtime.OffsetOutOfBoundsException - The offset is invalid.
javax.realtime.SizeOutOfBoundsException - The size is negative or extends into an invalid address range.

setLongs

void setLongs(long base,
              long offset,
              long[] longs,
              int low,
              int number)
              throws javax.realtime.OffsetOutOfBoundsException,
                     javax.realtime.SizeOutOfBoundsException
Sets number longs starting at the given offset from the long array passed starting at position low.

Parameters:
base - base address of the RawMemoryAccess caller
offset - The offset at which to start writing.
longs - The array from which the items are obtained.
low - The offset which is the starting point in the given array for the items to be obtained.
number - The number of items to write.
Throws:
javax.realtime.OffsetOutOfBoundsException - The offset is invalid.
javax.realtime.SizeOutOfBoundsException - The size is negative or extends into an invalid address range.

setShort

void setShort(long base,
              long offset,
              short value)
              throws javax.realtime.OffsetOutOfBoundsException,
                     javax.realtime.SizeOutOfBoundsException
Sets the short at the given offset.

Parameters:
base - base address of the RawMemoryAccess caller
offset - The offset at which to write the short.
value - The short to write.
Throws:
javax.realtime.OffsetOutOfBoundsException - The offset is invalid.
javax.realtime.SizeOutOfBoundsException - The size is negative or extends into an invalid address range.

setShorts

void setShorts(long base,
               long offset,
               short[] shorts,
               int low,
               int number)
               throws javax.realtime.OffsetOutOfBoundsException,
                      javax.realtime.SizeOutOfBoundsException
Sets number shorts starting at the given offset from the short array passed starting at position low.

Parameters:
base - base address of the RawMemoryAccess caller
offset - The offset at which to start writing.
shorts - The array from which the items are obtained.
low - The offset which is the starting point in the given array for the items to be obtained.
number - The number of items to write.
Throws:
javax.realtime.OffsetOutOfBoundsException - The offset is invalid.
javax.realtime.SizeOutOfBoundsException - The size is negative or extends into an invalid address range.

getDouble

double getDouble(long base,
                 long offset)
                 throws javax.realtime.OffsetOutOfBoundsException,
                        javax.realtime.SizeOutOfBoundsException
Gets the double at the given offset.

Parameters:
base - base address of the RawMemoryAccess caller
offset - The offset at which to write the value.
Returns:
The double value.
Throws:
javax.realtime.OffsetOutOfBoundsException - The address is invalid.
javax.realtime.SizeOutOfBoundsException - The size is negative or extends into an invalid range of memory.

getDoubles

void getDoubles(long base,
                long offset,
                double[] doubles,
                int low,
                int number)
                throws javax.realtime.OffsetOutOfBoundsException,
                       javax.realtime.SizeOutOfBoundsException
Gets number double values starting at the given offset in this, and assigns them into the double array starting at position low.

Parameters:
base - base address of the RawMemoryAccess caller
offset - The offset at which to start reading.
doubles - The array into which the read items are placed.
low - The offset which is the starting point in the given array for the read items to be placed.
number - The number of items to read.
Throws:
javax.realtime.OffsetOutOfBoundsException - The address is invalid.
javax.realtime.SizeOutOfBoundsException - The size is negative or extends into an invalid range of memory.

getFloat

float getFloat(long base,
               long offset)
               throws javax.realtime.OffsetOutOfBoundsException,
                      javax.realtime.SizeOutOfBoundsException
Gets the float at the given offset.

Parameters:
base - base address of the RawMemoryAccess caller
offset - The offset at which to get the value.
Returns:
The float value.
Throws:
javax.realtime.OffsetOutOfBoundsException - The address is invalid.
javax.realtime.SizeOutOfBoundsException - The size is negative or extends into an invalid range of memory.

getFloats

void getFloats(long base,
               long offset,
               float[] floats,
               int low,
               int number)
               throws javax.realtime.OffsetOutOfBoundsException,
                      javax.realtime.SizeOutOfBoundsException
Gets number float values starting at the given offset in this and assign them into the byte array starting at position low.

Parameters:
base - base address of the RawMemoryAccess caller
offset - The offset at which to start reading.
floats - The array into which the read items are placed.
low - The offset which is the starting point in the given array for the read items to be placed.
number - The number of items to read.
Throws:
javax.realtime.OffsetOutOfBoundsException - The address is invalid.
javax.realtime.SizeOutOfBoundsException - The size is negative or extends into an invalid range of memory.
javax.realtime.OffsetOutOfBoundsException - The address is invalid.
javax.realtime.SizeOutOfBoundsException - The size is negative or extends into an invalid range of memory.

setFloat

void setFloat(long base,
              long offset,
              float value)
              throws javax.realtime.OffsetOutOfBoundsException,
                     javax.realtime.SizeOutOfBoundsException
Sets the float at the given offset.

Parameters:
base - base address of the RawMemoryAccess caller
offset - The offset at which to write the value.
value - The value which will be written.
Throws:
javax.realtime.OffsetOutOfBoundsException - The address is invalid.
javax.realtime.SizeOutOfBoundsException - The size is negative or extends into an invalid range of memory.

setFloats

void setFloats(long base,
               long offset,
               float[] floats,
               int low,
               int number)
               throws javax.realtime.OffsetOutOfBoundsException,
                      javax.realtime.SizeOutOfBoundsException
Sets number float values starting at the given offset in this from the byte array starting at position low.

Parameters:
base - base address of the RawMemoryAccess caller
offset - The offset at which to start writing.
floats - The array from which the items are obtained.
low - The offset which is the starting point in the given array for the items to be obtained.
number - The number of items to write.
Throws:
javax.realtime.OffsetOutOfBoundsException - The address is invalid.
javax.realtime.SizeOutOfBoundsException - The size is negative or extends into an invalid range of memory.

setDouble

void setDouble(long base,
               long offset,
               double value)
               throws javax.realtime.OffsetOutOfBoundsException,
                      javax.realtime.SizeOutOfBoundsException
Sets the double at the given offset.

Parameters:
base - base address of the RawMemoryAccess caller
offset - The offset at which to set the value.
value - The value which will be written.
Throws:
javax.realtime.OffsetOutOfBoundsException - The address is invalid.
javax.realtime.SizeOutOfBoundsException - The size is negative or extends into an invalid range of memory.

setDoubles

void setDoubles(long base,
                long offset,
                double[] doubles,
                int low,
                int number)
                throws javax.realtime.OffsetOutOfBoundsException,
                       javax.realtime.SizeOutOfBoundsException
Sets number double values starting at the given offset in this, and assigns them into the double array starting at position low.

Parameters:
base - base address of the RawMemoryAccess caller
offset - The offset at which to start writing.
doubles - The array from which the items are obtained.
low - The offset which is the starting point in the given array for the items to be obtained.
number - The number of items to write.
Throws:
javax.realtime.OffsetOutOfBoundsException - The address is invalid.
javax.realtime.SizeOutOfBoundsException - The size is negative or extends into an invalid range of memory.