Package org.python.modules.jffi
Class InvalidMemory
- java.lang.Object
-
- org.python.modules.jffi.InvalidMemory
-
- All Implemented Interfaces:
Memory
- Direct Known Subclasses:
NullMemory
public abstract class InvalidMemory extends java.lang.Object implements Memory
An implementation of Memory that throws an exception on any access.
-
-
Constructor Summary
Constructors Constructor Description InvalidMemory(java.lang.String message)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description java.nio.ByteBuffer
asByteBuffer()
void
clear()
void
get(long offset, byte[] dst, int off, int len)
Reads an array of bytes from the memory area at the specified offset.void
get(long offset, double[] dst, int off, int len)
Reads an array of doubles from the memory area at the specified offset.void
get(long offset, float[] dst, int off, int len)
Reads an array of floats from the memory area at the specified offset.void
get(long offset, int[] dst, int off, int len)
Reads an array of ints from the memory area at the specified offset.void
get(long offset, long[] dst, int off, int len)
Reads an array of longs from the memory area at the specified offset.void
get(long offset, short[] dst, int off, int len)
Reads an array of shorts from the memory area at the specified offset.long
getAddress(long offset)
Reads a pointer value at the specified offset within the memory area.byte
getByte(long offset)
Reads an 8 bit integer value from the memory area.double
getDouble(long offset)
Reads a double value from the memory area.float
getFloat(long offset)
Reads a float value from the memory area.int
getInt(long offset)
Reads a 32 bit integer value from the memory area.long
getLong(long offset)
Reads a 64 bit integer value from the memory area.DirectMemory
getMemory(long offset)
Reads a pointer value at the specified offset within the memory area, and wraps it in an abstract memory accessor.long
getNativeLong(long offset)
Reads a native long integer value from the memory area.short
getShort(long offset)
Reads a 16 bit integer value from the memory area.byte[]
getZeroTerminatedByteArray(long offset)
Reads a zero terminated byte array (e.g. an ascii or utf-8 string)byte[]
getZeroTerminatedByteArray(long offset, int maxlen)
int
indexOf(long offset, byte value)
Gets the first index within the memory area of a particular 8 bit value.int
indexOf(long offset, byte value, int maxlen)
Gets the first index within the memory area of a particular 8 bit value.void
put(long offset, byte[] src, int off, int len)
Writes an array of bytes to the memory area at the specified offset.void
put(long offset, double[] src, int off, int len)
Writes an array of doubles to the memory area at the specified offset.void
put(long offset, float[] src, int off, int len)
Writes an array of floats to the memory area at the specified offset.void
put(long offset, int[] src, int off, int len)
Writes an array of ints to the memory area at the specified offset.void
put(long offset, long[] src, int off, int len)
Writes an array of longs to the memory area at the specified offset.void
put(long offset, short[] src, int off, int len)
Writes an array of shorts to the memory area at the specified offset.void
putAddress(long offset, long value)
Writes a pointer value to the memory area at the specified offset.void
putAddress(long offset, Memory value)
Writes a pointer value to the memory area at the specified offset.void
putByte(long offset, byte value)
Writes an 8 bit integer value to the memory area at the specified offset.void
putDouble(long offset, double value)
Writes a 64 bit float value to the memory area at the specified offset.void
putFloat(long offset, float value)
Writes a 32 bit float value to the memory area at the specified offset.void
putInt(long offset, int value)
Writes a 32 bit integer value to the memory area at the specified offset.void
putLong(long offset, long value)
Writes a 64 bit integer value to the memory area at the specified offset.void
putMemory(long offset, Memory value)
void
putNativeLong(long offset, long value)
Writes a native long integer value to the memory area at the specified offset.void
putShort(long offset, short value)
Writes a 16 bit integer value to the memory area at the specified offset.void
putZeroTerminatedByteArray(long offset, byte[] bytes, int off, int len)
Writes a byte array to memory, and appends a zero terminatorvoid
setMemory(long offset, long size, byte value)
Sets the contents of the memory area to the value.Memory
slice(long offset)
Creates a new MemoryIO pointing to a subset of the memory area of this MemoryIO.
-
-
-
Method Detail
-
slice
public Memory slice(long offset)
Description copied from interface:Memory
Creates a new MemoryIO pointing to a subset of the memory area of this MemoryIO.
-
asByteBuffer
public java.nio.ByteBuffer asByteBuffer()
-
getByte
public final byte getByte(long offset)
Description copied from interface:Memory
Reads an 8 bit integer value from the memory area.
-
getShort
public final short getShort(long offset)
Description copied from interface:Memory
Reads a 16 bit integer value from the memory area.
-
getInt
public final int getInt(long offset)
Description copied from interface:Memory
Reads a 32 bit integer value from the memory area.
-
getLong
public final long getLong(long offset)
Description copied from interface:Memory
Reads a 64 bit integer value from the memory area.
-
getNativeLong
public final long getNativeLong(long offset)
Description copied from interface:Memory
Reads a native long integer value from the memory area.A native long is 32bits on either ILP32 or LLP64 architectures, and 64 bits on an LP64 architecture.
This means that it will always read a 32bit value on Windows, but on Unix systems such as MacOS or Linux, it will read a 32bit value on 32bit systems, and a 64bit value on 64bit systems.
- Specified by:
getNativeLong
in interfaceMemory
- Parameters:
offset
- The offset within the memory area to read the value.- Returns:
- The native long value read from offset
-
getFloat
public final float getFloat(long offset)
Description copied from interface:Memory
Reads a float value from the memory area.
-
getDouble
public final double getDouble(long offset)
Description copied from interface:Memory
Reads a double value from the memory area.
-
getMemory
public final DirectMemory getMemory(long offset)
Description copied from interface:Memory
Reads a pointer value at the specified offset within the memory area, and wraps it in an abstract memory accessor.
-
getAddress
public final long getAddress(long offset)
Description copied from interface:Memory
Reads a pointer value at the specified offset within the memory area.- Specified by:
getAddress
in interfaceMemory
- Parameters:
offset
- The offset within the memory area to read the value.- Returns:
- A long value that represents the address.
-
putByte
public final void putByte(long offset, byte value)
Description copied from interface:Memory
Writes an 8 bit integer value to the memory area at the specified offset.
-
putShort
public final void putShort(long offset, short value)
Description copied from interface:Memory
Writes a 16 bit integer value to the memory area at the specified offset.
-
putInt
public final void putInt(long offset, int value)
Description copied from interface:Memory
Writes a 32 bit integer value to the memory area at the specified offset.
-
putLong
public final void putLong(long offset, long value)
Description copied from interface:Memory
Writes a 64 bit integer value to the memory area at the specified offset.
-
putNativeLong
public final void putNativeLong(long offset, long value)
Description copied from interface:Memory
Writes a native long integer value to the memory area at the specified offset.- Specified by:
putNativeLong
in interfaceMemory
- Parameters:
offset
- The offset within the memory area to write the value.value
- The native long integer value to write to the memory location.
-
putFloat
public final void putFloat(long offset, float value)
Description copied from interface:Memory
Writes a 32 bit float value to the memory area at the specified offset.
-
putDouble
public final void putDouble(long offset, double value)
Description copied from interface:Memory
Writes a 64 bit float value to the memory area at the specified offset.
-
putMemory
public final void putMemory(long offset, Memory value)
-
putAddress
public final void putAddress(long offset, long value)
Description copied from interface:Memory
Writes a pointer value to the memory area at the specified offset.- Specified by:
putAddress
in interfaceMemory
- Parameters:
offset
- The offset within the memory area to write the value.value
- The pointer value to write to the memory location.
-
putAddress
public final void putAddress(long offset, Memory value)
Description copied from interface:Memory
Writes a pointer value to the memory area at the specified offset.- Specified by:
putAddress
in interfaceMemory
- Parameters:
offset
- The offset within the memory area to write the value.value
- The pointer value to write to the memory location.
-
get
public final void get(long offset, byte[] dst, int off, int len)
Description copied from interface:Memory
Reads an array of bytes from the memory area at the specified offset.
-
put
public final void put(long offset, byte[] src, int off, int len)
Description copied from interface:Memory
Writes an array of bytes to the memory area at the specified offset.
-
get
public final void get(long offset, short[] dst, int off, int len)
Description copied from interface:Memory
Reads an array of shorts from the memory area at the specified offset.
-
put
public final void put(long offset, short[] src, int off, int len)
Description copied from interface:Memory
Writes an array of shorts to the memory area at the specified offset.
-
get
public final void get(long offset, int[] dst, int off, int len)
Description copied from interface:Memory
Reads an array of ints from the memory area at the specified offset.
-
put
public final void put(long offset, int[] src, int off, int len)
Description copied from interface:Memory
Writes an array of ints to the memory area at the specified offset.
-
get
public final void get(long offset, long[] dst, int off, int len)
Description copied from interface:Memory
Reads an array of longs from the memory area at the specified offset.
-
put
public final void put(long offset, long[] src, int off, int len)
Description copied from interface:Memory
Writes an array of longs to the memory area at the specified offset.
-
get
public final void get(long offset, float[] dst, int off, int len)
Description copied from interface:Memory
Reads an array of floats from the memory area at the specified offset.
-
put
public final void put(long offset, float[] src, int off, int len)
Description copied from interface:Memory
Writes an array of floats to the memory area at the specified offset.
-
get
public final void get(long offset, double[] dst, int off, int len)
Description copied from interface:Memory
Reads an array of doubles from the memory area at the specified offset.
-
put
public final void put(long offset, double[] src, int off, int len)
Description copied from interface:Memory
Writes an array of doubles to the memory area at the specified offset.
-
indexOf
public final int indexOf(long offset, byte value)
Description copied from interface:Memory
Gets the first index within the memory area of a particular 8 bit value.
-
indexOf
public final int indexOf(long offset, byte value, int maxlen)
Description copied from interface:Memory
Gets the first index within the memory area of a particular 8 bit value.
-
setMemory
public final void setMemory(long offset, long size, byte value)
Description copied from interface:Memory
Sets the contents of the memory area to the value.
-
clear
public final void clear()
-
getZeroTerminatedByteArray
public byte[] getZeroTerminatedByteArray(long offset)
Description copied from interface:Memory
Reads a zero terminated byte array (e.g. an ascii or utf-8 string)- Specified by:
getZeroTerminatedByteArray
in interfaceMemory
- Parameters:
offset
- The offset within the memory area of the start of the string.- Returns:
- A byte array containing a copy of the data.
-
getZeroTerminatedByteArray
public byte[] getZeroTerminatedByteArray(long offset, int maxlen)
-
putZeroTerminatedByteArray
public void putZeroTerminatedByteArray(long offset, byte[] bytes, int off, int len)
Description copied from interface:Memory
Writes a byte array to memory, and appends a zero terminator- Specified by:
putZeroTerminatedByteArray
in interfaceMemory
- Parameters:
offset
- The offset within the memory area of the start of the string.bytes
- The byte array to write to the memory.off
- The offset with the byte array to start copying.len
- The number of bytes of the byte array to write to the memory area. (not including zero byte)
-
-