jnr.ffi.provider
Class BoundedMemoryIO

java.lang.Object
  jnr.ffi.Pointer
      jnr.ffi.provider.AbstractMemoryIO
          jnr.ffi.provider.BoundedMemoryIO

All Implemented Interfaces:

DelegatingMemoryIO

public final class BoundedMemoryIO
extends AbstractMemoryIO
implements DelegatingMemoryIO

Constructor Summary

BoundedMemoryIO(Pointer parent, long offset, long size)

Method Summary

long	address() Gets the native address of this memory object (optional operation).
java.lang.Object	array()
int	arrayLength()
int	arrayOffset()
void	checkBounds(long offset, long length) Checks that the memory region is within the bounds of this memory object
boolean	equals(java.lang.Object obj)
void	get(long offset, byte[] dst, int off, int len) Bulk get method for multiple byte values.
void	get(long offset, double[] dst, int off, int len) Bulk get method for multiple double values.
void	get(long offset, float[] dst, int off, int len) Bulk get method for multiple float values.
void	get(long offset, int[] dst, int off, int len) Bulk get method for multiple int values.
void	get(long offset, long[] dst, int off, int len) Bulk get method for multiple long values.
void	get(long offset, short[] dst, int off, int len) Bulk get method for multiple short values.
long	getAddress(long offset)
byte	getByte(long offset) Reads an byte (8 bit) value at the given offset.
Pointer	getDelegatedMemoryIO()
double	getDouble(long offset) Reads a double (64 bit) value at the given offset.
float	getFloat(long offset) Reads a float (32 bit) value at the given offset.
int	getInt(long offset) Reads an int (32 bit) value at the given offset.
long	getLongLong(long offset) Reads a long (64 bit) value at the given offset.
Pointer	getPointer(long offset) Reads an Pointer value at the given offset.
Pointer	getPointer(long offset, long size) Reads an Pointer value at the given offset.
short	getShort(long offset) Reads a short (16 bit) value at the given offset.
java.lang.String	getString(long offset) Reads an String value at the given offset.
java.lang.String	getString(long offset, int maxLength, java.nio.charset.Charset cs) Reads a String value at the given offset, using a specific Charset
boolean	hasArray()
int	hashCode()
int	indexOf(long offset, byte value) Returns the location of a byte value within the memory area represented by this Pointer.
int	indexOf(long offset, byte value, int maxlen) Returns the location of a byte value within the memory area represented by this Pointer.
boolean	isDirect() Indicates whether or not this memory object represents a native memory address.
void	put(long offset, byte[] dst, int off, int len) Bulk put method for multiple byte values.
void	put(long offset, double[] dst, int off, int len) Bulk put method for multiple double values.
void	put(long offset, float[] dst, int off, int len) Bulk put method for multiple float values.
void	put(long offset, int[] dst, int off, int len) Bulk put method for multiple int values.
void	put(long offset, long[] dst, int off, int len) Bulk put method for multiple long values.
void	put(long offset, short[] dst, int off, int len) Bulk put method for multiple short values.
void	putAddress(long offset, Address value)
void	putAddress(long offset, long value)
void	putByte(long offset, byte value) Writes a byte (8 bit) value at the given offset.
void	putDouble(long offset, double value) Writes a double (64 bit, double precision) value at the given offset.
void	putFloat(long offset, float value) Writes a float (32 bit, single precision) value at the given offset.
void	putInt(long offset, int value) Writes an int (32 bit) value at the given offset.
void	putLongLong(long offset, long value) Writes a long (64 bit) value at the given offset.
void	putPointer(long offset, Pointer value) Writes a Pointer value at the given offset.
void	putShort(long offset, short value) Writes a short (16 bit) value at the given offset.
void	putString(long offset, java.lang.String string, int maxLength, java.nio.charset.Charset cs) Writes a String value at the given offset, using a specific Charset
void	setMemory(long offset, long size, byte value) Sets the value of each byte in the memory area represented by this Pointer.
long	size() Gets the size of this memory object (optional operation).
void	transferFrom(long offset, Pointer other, long otherOffset, long count) Bulk data transfer from one memory location to another.
void	transferTo(long offset, Pointer other, long otherOffset, long count) Bulk data transfer from one memory location to another.

Methods inherited from class jnr.ffi.provider.AbstractMemoryIO

checkBounds, getInt, getLong, getNativeLong, getRuntime, putInt, putLong, putNativeLong, slice, slice

Methods inherited from class jnr.ffi.Pointer

newIntPointer, wrap, wrap, wrap

Methods inherited from class java.lang.Object

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

Constructor Detail

BoundedMemoryIO

public BoundedMemoryIO(Pointer parent,
                       long offset,
                       long size)

Method Detail

isDirect

public boolean isDirect()

Description copied from class: Pointer

Indicates whether or not this memory object represents a native memory address.

Memory objects can be either direct (representing native memory), or non-direct (representing java heap memory).

Non-direct memory objects can still be passed to native functions as pointer (void *, char *, etc) parameters, but the java memory will first be copied to a temporary native memory area. The temporary memory area will then be used as the parameter value for the call. If needed, the java memory will be automatically reloaded from the temporary native memory after the native function returns.

Note: the transient nature of the temporary memory allocated for non-direct memory means native functions which store the address value passed to them will fail in unpredictable ways when using non-direct memory. You will need to explicitly allocate direct memory to use those types of functions.

Specified by:

isDirect in class Pointer

Returns:

true if, and only if, this memory object represents a native address.

address

public long address()

Description copied from class: Pointer

Gets the native address of this memory object (optional operation).

Specified by:

address in class Pointer

Returns:

the native address of this memory object. If this object is not a native memory address, an address of zero is returned.

size

public long size()

Description copied from class: Pointer

Gets the size of this memory object (optional operation).

Specified by:

size in class Pointer

Returns:

the size of the memory area this Pointer points to. If the size is unknown, Long.MAX_VALUE is returned}.

hasArray

public final boolean hasArray()

Specified by:

hasArray in class Pointer

array

public final java.lang.Object array()

Specified by:

array in class Pointer

arrayOffset

public final int arrayOffset()

Specified by:

arrayOffset in class Pointer

arrayLength

public final int arrayLength()

Specified by:

arrayLength in class Pointer

checkBounds

public void checkBounds(long offset,
                        long length)

Description copied from class: Pointer

Checks that the memory region is within the bounds of this memory object

Overrides:

checkBounds in class AbstractMemoryIO

Parameters:

offset - the starting point within this memory region.

length - the length of the memory region in bytes

getDelegatedMemoryIO

public Pointer getDelegatedMemoryIO()

Specified by:

getDelegatedMemoryIO in interface DelegatingMemoryIO

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

getByte

public byte getByte(long offset)

Description copied from class: Pointer

Reads an byte (8 bit) value at the given offset.

Specified by:

getByte in class Pointer

Parameters:

offset - The offset from the start of the memory this Pointer represents at which the value will be read.

Returns:

the byte value at the offset.

getShort

public short getShort(long offset)

Description copied from class: Pointer

Reads a short (16 bit) value at the given offset.

Specified by:

getShort in class Pointer

Parameters:

offset - The offset from the start of the memory this Pointer represents at which the value will be read.

Returns:

the short value at the offset.

getInt

public int getInt(long offset)

Description copied from class: Pointer

Reads an int (32 bit) value at the given offset.

Specified by:

getInt in class Pointer

Parameters:

offset - The offset from the start of the memory this Pointer represents at which the value will be read.

Returns:

the int value contained in the memory at the offset.

getLongLong

public long getLongLong(long offset)

Description copied from class: Pointer

Reads a long (64 bit) value at the given offset.

Specified by:

getLongLong in class Pointer

Parameters:

offset - The offset from the start of the memory this Pointer represents at which the value will be read.

Returns:

the long value at the offset.

getFloat

public float getFloat(long offset)

Description copied from class: Pointer

Reads a float (32 bit) value at the given offset.

Specified by:

getFloat in class Pointer

Parameters:

offset - The offset from the start of the memory this Pointer represents at which the value will be read.

Returns:

the float value at the offset.

getDouble

public double getDouble(long offset)

Description copied from class: Pointer

Reads a double (64 bit) value at the given offset.

Specified by:

getDouble in class Pointer

Parameters:

offset - The offset from the start of the memory this Pointer represents at which the value will be read.

Returns:

the double value at the offset.

getPointer

public Pointer getPointer(long offset)

Description copied from class: Pointer

Reads an Pointer value at the given offset.

Specified by:

getPointer in class Pointer

Parameters:

offset - the offset from the start of the memory this Pointer represents at which the value will be read.

Returns:

the Pointer value read from memory.

getPointer

public Pointer getPointer(long offset,
                          long size)

Description copied from class: Pointer

Reads an Pointer value at the given offset.

Specified by:

getPointer in class Pointer

Parameters:

offset - the offset from the start of the memory this Pointer represents at which the value will be read.

size - the maximum size of the memory location the returned Pointer represents.

Returns:

the Pointer value read from memory.

putByte

public void putByte(long offset,
                    byte value)

Description copied from class: Pointer

Writes a byte (8 bit) value at the given offset.

Specified by:

putByte in class Pointer

Parameters:

offset - The offset from the start of the memory this Pointer represents at which the value will be written.

value - the byte value to be written.

putShort

public void putShort(long offset,
                     short value)

Description copied from class: Pointer

Writes a short (16 bit) value at the given offset.

Specified by:

putShort in class Pointer

Parameters:

offset - The offset from the start of the memory this Pointer represents at which the value will be written.

value - the short value to be written.

putInt

public void putInt(long offset,
                   int value)

Description copied from class: Pointer

Writes an int (32 bit) value at the given offset.

Specified by:

putInt in class Pointer

Parameters:

offset - The offset from the start of the memory this Pointer represents at which the value will be written.

value - the int value to be written.

putLongLong

public void putLongLong(long offset,
                        long value)

Description copied from class: Pointer

Writes a long (64 bit) value at the given offset.

Specified by:

putLongLong in class Pointer

Parameters:

offset - The offset from the start of the memory this Pointer represents at which the value will be written.

value - the long value to be written.

putFloat

public void putFloat(long offset,
                     float value)

Description copied from class: Pointer

Writes a float (32 bit, single precision) value at the given offset.

Specified by:

putFloat in class Pointer

Parameters:

offset - The offset from the start of the memory this Pointer represents at which the value will be written.

value - the float value to be written.

putDouble

public void putDouble(long offset,
                      double value)

Description copied from class: Pointer

Writes a double (64 bit, double precision) value at the given offset.

Specified by:

putDouble in class Pointer

Parameters:

offset - The offset from the start of the memory this Pointer represents at which the value will be written.

value - the double value to be written.

putPointer

public void putPointer(long offset,
                       Pointer value)

Description copied from class: Pointer

Writes a Pointer value at the given offset.

Specified by:

putPointer in class Pointer

Parameters:

offset - The offset from the start of the memory this Pointer represents at which the value will be written.

value - the Pointer value to be written to memory.

get

public void get(long offset,
                byte[] dst,
                int off,
                int len)

Description copied from class: Pointer

Bulk get method for multiple byte values. This method reads multiple byte values from consecutive addresses, beginning at the given offset, and stores them in an array.

Specified by:

get in class Pointer

Parameters:

offset - the offset from the start of the memory this Pointer represents at which the first value will be read.

dst - the array into which values are to be stored.

off - the start index in the dst array to begin storing the values.

len - the number of values to be read.

put

public void put(long offset,
                byte[] dst,
                int off,
                int len)

Description copied from class: Pointer

Bulk put method for multiple byte values. This method writes multiple byte values to consecutive addresses, beginning at the given offset, from an array.

Specified by:

put in class Pointer

Parameters:

offset - the offset from the start of the memory this Pointer represents at which the first value will be written.

dst - the array to get values from.

off - the start index in the dst array to begin reading values.

len - the number of values to be written.

get

public void get(long offset,
                short[] dst,
                int off,
                int len)

Description copied from class: Pointer

Bulk get method for multiple short values. This method reads multiple short values from consecutive addresses, beginning at the given offset, and stores them in an array.

Specified by:

get in class Pointer

Parameters:

offset - The offset from the start of the memory this Pointer represents at which the first value will be read.

dst - The array into which values are to be stored.

off - the start index in the dst array to begin storing the values.

len - the number of values to be read.

put

public void put(long offset,
                short[] dst,
                int off,
                int len)

Description copied from class: Pointer

Bulk put method for multiple short values. This method writes multiple short values to consecutive addresses, beginning at the given offset, from an array.

Specified by:

put in class Pointer

Parameters:

offset - the offset from the start of the memory this Pointer represents at which the first value will be written.

dst - the array to get values from.

off - the start index in the dst array to begin reading values.

len - the number of values to be written.

get

public void get(long offset,
                int[] dst,
                int off,
                int len)

Description copied from class: Pointer

Bulk get method for multiple int values. This method reads multiple int values from consecutive addresses, beginning at the given offset, and stores them in an array.

Specified by:

get in class Pointer

Parameters:

offset - The offset from the start of the memory this Pointer represents at which the first value will be read.

dst - The array into which values are to be stored.

off - the start index in the dst array to begin storing the values.

len - the number of values to be read.

put

public void put(long offset,
                int[] dst,
                int off,
                int len)

Description copied from class: Pointer

Bulk put method for multiple int values. This method writes multiple int values to consecutive addresses, beginning at the given offset, from an array.

Specified by:

put in class Pointer

Parameters:

offset - the offset from the start of the memory this Pointer represents at which the first value will be written.

dst - the array to get values from.

off - the start index in the dst array to begin reading values.

len - the number of values to be written.

get

public void get(long offset,
                long[] dst,
                int off,
                int len)

Description copied from class: Pointer

Bulk get method for multiple long values. This method reads multiple long values from consecutive addresses, beginning at the given offset, and stores them in an array.

Specified by:

get in class Pointer

Parameters:

offset - The offset from the start of the memory this Pointer represents at which the first value will be read.

dst - The array into which values are to be stored.

off - the start index in the dst array to begin storing the values.

len - the number of values to be read.

put

public void put(long offset,
                long[] dst,
                int off,
                int len)

Description copied from class: Pointer

Bulk put method for multiple long values. This method writes multiple long values to consecutive addresses, beginning at the given offset, from an array.

Specified by:

put in class Pointer

Parameters:

offset - the offset from the start of the memory this Pointer represents at which the first value will be written.

dst - the array to get values from.

off - the start index in the dst array to begin reading values.

len - the number of values to be written.

get

public void get(long offset,
                float[] dst,
                int off,
                int len)

Description copied from class: Pointer

Bulk get method for multiple float values. This method reads multiple float values from consecutive addresses, beginning at the given offset, and stores them in an array.

Specified by:

get in class Pointer

Parameters:

offset - The offset from the start of the memory this Pointer represents at which the first value will be read.

dst - The array into which values are to be stored.

off - the start index in the dst array to begin storing the values.

len - the number of values to be read.

put

public void put(long offset,
                float[] dst,
                int off,
                int len)

Description copied from class: Pointer

Bulk put method for multiple float values. This method writes multiple float values to consecutive addresses, beginning at the given offset, from an array.

Specified by:

put in class Pointer

Parameters:

offset - the offset from the start of the memory this Pointer represents at which the first value will be written.

dst - the array to get values from.

off - the start index in the dst array to begin reading values.

len - the number of values to be written.

get

public void get(long offset,
                double[] dst,
                int off,
                int len)

Description copied from class: Pointer

Bulk get method for multiple double values. This method reads multiple double values from consecutive addresses, beginning at the given offset, and stores them in an array.

Specified by:

get in class Pointer

Parameters:

offset - The offset from the start of the memory this Pointer represents at which the first value will be read.

dst - The array into which values are to be stored.

off - the start index in the dst array to begin storing the values.

len - the number of values to be read.

put

public void put(long offset,
                double[] dst,
                int off,
                int len)

Description copied from class: Pointer

Bulk put method for multiple double values. This method writes multiple double values to consecutive addresses, beginning at the given offset, from an array.

Specified by:

put in class Pointer

Parameters:

offset - the offset from the start of the memory this Pointer represents at which the first value will be written.

dst - the array to get values from.

off - the start index in the dst array to begin reading values.

len - the number of values to be written.

getAddress

public long getAddress(long offset)

Overrides:

getAddress in class AbstractMemoryIO

getString

public java.lang.String getString(long offset,
                                  int maxLength,
                                  java.nio.charset.Charset cs)

Description copied from class: Pointer

Reads a String value at the given offset, using a specific Charset

Specified by:

getString in class Pointer

Parameters:

offset - the offset from the start of the memory this Pointer represents at which the value will be read.

maxLength - the maximum size of memory to search for a NUL byte.

cs - the Charset to use to decode the string.

Returns:

the String value read from memory.

getString

public java.lang.String getString(long offset)

Description copied from class: Pointer

Reads an String value at the given offset.

Specified by:

getString in class Pointer

Parameters:

offset - the offset from the start of the memory this Pointer represents at which the value will be read.

Returns:

the String value read from memory.

putAddress

public void putAddress(long offset,
                       long value)

Overrides:

putAddress in class AbstractMemoryIO

putAddress

public void putAddress(long offset,
                       Address value)

Overrides:

putAddress in class AbstractMemoryIO

putString

public void putString(long offset,
                      java.lang.String string,
                      int maxLength,
                      java.nio.charset.Charset cs)

Description copied from class: Pointer

Writes a String value at the given offset, using a specific Charset

Specified by:

putString in class Pointer

Parameters:

offset - the offset from the start of the memory this Pointer represents at which the value will be written.

maxLength - the maximum size of memory to use to store the string.

cs - the Charset to use to decode the string.

indexOf

public int indexOf(long offset,
                   byte value)

Description copied from class: Pointer

Returns the location of a byte value within the memory area represented by this Pointer.

Overrides:

indexOf in class AbstractMemoryIO

Parameters:

offset - the offset from the start of the memory location this Pointer represents to begin searching.

value - the byte value to locate.

Returns:

the offset from the start of the search area (i.e. relative to the offset parameter), or -1 if not found.

indexOf

public int indexOf(long offset,
                   byte value,
                   int maxlen)

Description copied from class: Pointer

Returns the location of a byte value within the memory area represented by this Pointer.

Specified by:

indexOf in class Pointer

Parameters:

offset - the offset from the start of the memory location this Pointer represents to begin searching.

value - the byte value to locate.

maxlen - the maximum number of bytes to search for the desired value.

Returns:

the offset from the start of the search area (i.e. relative to the offset parameter), or -1 if not found.

setMemory

public void setMemory(long offset,
                      long size,
                      byte value)

Description copied from class: Pointer

Sets the value of each byte in the memory area represented by this Pointer. to a specified value.

Specified by:

setMemory in class Pointer

Parameters:

offset - the offset from the start of the memory location this Pointer represents to begin writing to.

size - the number of bytes to set to the value.

value - the value to set each byte to.

transferFrom

public void transferFrom(long offset,
                         Pointer other,
                         long otherOffset,
                         long count)

Description copied from class: Pointer

Bulk data transfer from one memory location to another.

Overrides:

transferFrom in class AbstractMemoryIO

Parameters:

offset - the offset from the start of the memory location this Pointer represents to begin copying to.

other - the destination memory location to transfer data from.

otherOffset - the offset from the start of the memory location the destination Pointer represents to begin copying from.

count - the number of bytes to transfer.

transferTo

public void transferTo(long offset,
                       Pointer other,
                       long otherOffset,
                       long count)

Description copied from class: Pointer

Bulk data transfer from one memory location to another.

Overrides:

transferTo in class AbstractMemoryIO

Parameters:

offset - the offset from the start of the memory location this Pointer represents to begin copying from.

other - the destination memory location to transfer data to.

otherOffset - the offset from the start of the memory location the destination Pointer represents to begin copying to.

count - the number of bytes to transfer.