jnr.ffi.StructLayout Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of jnr-ffi Show documentation
Show all versions of jnr-ffi Show documentation
A library for invoking native functions from java
/*
* Copyright (C) 2011 Wayne Meissner
*
* This file is part of the JNR project.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package jnr.ffi;
import jnr.ffi.util.EnumMapper;
import java.lang.reflect.Constructor;
import java.nio.charset.Charset;
/**
*
*/
public class StructLayout extends Type {
static final Charset ASCII = Charset.forName("ASCII");
static final Charset UTF8 = Charset.forName("UTF-8");
private final Runtime runtime;
private final boolean isUnion = false;
private boolean resetIndex = false;
StructLayout enclosing = null;
int offset = 0;
int size = 0;
int alignment = 1;
int paddedSize = 0;
/**
* Creates a new StructLayout.
*
* @param runtime The current runtime.
*/
protected StructLayout(Runtime runtime) {
this.runtime = runtime;
}
protected StructLayout(Runtime runtime, int structSize) {
this.runtime = runtime;
this.size = this.paddedSize = structSize;
}
public final Runtime getRuntime() {
return this.runtime;
}
public final int size() {
return paddedSize;
}
public final int alignment() {
return alignment;
}
public final int offset() {
return offset;
}
public NativeType getNativeType() {
return NativeType.STRUCT;
}
/**
* Returns a human readable {@link java.lang.String} representation of the structure.
*
* @return a {@code String} representation of this structure.
*/
@Override
public java.lang.String toString() {
StringBuilder sb = new StringBuilder();
java.lang.reflect.Field[] fields = getClass().getDeclaredFields();
sb.append(getClass().getSimpleName()).append(" { \n");
final java.lang.String fieldPrefix = " ";
for (java.lang.reflect.Field field : fields) {
try {
sb.append(fieldPrefix).append('\n');
} catch (Throwable ex) {
throw new RuntimeException(ex);
}
}
sb.append("}\n");
return sb.toString();
}
private static int align(int offset, int alignment) {
return (offset + alignment - 1) & ~(alignment - 1);
}
protected final int addField(int size, int align) {
final int off = resetIndex ? 0 : align(this.size, align);
this.size = Math.max(this.size, off + size);
this.alignment = Math.max(this.alignment, align);
this.paddedSize = align(this.size, this.alignment);
return off;
}
protected final int addField(int size, int align, Offset offset) {
this.size = Math.max(this.size, offset.intValue() + size);
this.alignment = Math.max(this.alignment, align);
this.paddedSize = align(this.size, this.alignment);
return offset.intValue();
}
protected final int addField(Type t) {
return addField(t.size(), t.alignment());
}
protected final int addField(Type t, Offset offset) {
return addField(t.size(), t.alignment(), offset);
}
protected final Offset at(int offset) {
return new Offset(offset);
}
/**
* Interface all Struct members must implement.
*/
protected abstract class Field {
private final int offset;
protected Field(int offset) {
this.offset = offset;
}
/**
* Gets the Struct this Member is a member of.
*
* @return a Struct.
*/
public final StructLayout enclosing() {
return StructLayout.this;
}
/**
* Gets the offset within the structure for this field.
*
* @return the offset within the structure.
*/
public final long offset() {
return offset + StructLayout.this.offset;
}
}
/**
* Starts an array construction session
*/
protected final void arrayBegin() {
resetIndex = false;
}
/**
* Ends an array construction session
*/
protected final void arrayEnd() {
resetIndex = isUnion;
}
/**
* Creates an array of Member instances.
*
* @param The type of the Member subclass to create.
* @param array the array to store the instances in
* @return the array that was passed in
*/
@SuppressWarnings("unchecked")
protected T[] array(T[] array) {
arrayBegin();
try {
Class arrayClass = array.getClass().getComponentType();
Constructor ctor = arrayClass.getDeclaredConstructor(new Class[] { arrayClass.getEnclosingClass() });
Object[] parameters = { StructLayout.this };
for (int i = 0; i < array.length; ++i) {
array[i] = (T) ctor.newInstance(parameters);
}
} catch (Exception ex) {
throw new RuntimeException(ex);
}
arrayEnd();
return array;
}
protected final T inner(T structLayout) {
structLayout.enclosing = this;
structLayout.offset = align(this.size, structLayout.alignment);
this.size = structLayout.offset + structLayout.size;
this.paddedSize = align(this.size, this.alignment());
return structLayout;
}
protected static final class Offset extends java.lang.Number {
private final int offset;
public Offset(int offset) {
this.offset = offset;
}
@Override
public int intValue() {
return offset;
}
@Override
public long longValue() {
return offset;
}
@Override
public float floatValue() {
return offset;
}
@Override
public double doubleValue() {
return offset;
}
}
/**
* Base implementation of Member
*/
protected abstract class AbstractField extends Field {
protected AbstractField(int size, int align, Offset offset) {
super(addField(size, align, offset));
}
protected AbstractField(int size, int align) {
super(addField(size, align));
}
protected AbstractField(NativeType type) {
super(addField(getRuntime().findType(type)));
}
protected AbstractField(Type type) {
super(addField(type));
}
protected AbstractField(NativeType type, Offset offset) {
super(addField(getRuntime().findType(type), offset));
}
protected AbstractField(Type type, Offset offset) {
super(addField(type, offset));
}
}
/**
* Base class for Boolean fields
*/
protected abstract class AbstractBoolean extends AbstractField {
protected AbstractBoolean(NativeType type) {
super(type);
}
protected AbstractBoolean(NativeType type, Offset offset) {
super(type, offset);
}
/**
* Gets the value for this field.
*
* @param ptr The pointer to the field.
* @return a boolean.
*/
public abstract boolean get(jnr.ffi.Pointer ptr);
/**
* Sets the field to a new value.
*
* @param ptr The pointer to the field.
* @param value The new value.
*/
public abstract void set(jnr.ffi.Pointer ptr, boolean value);
/**
* Returns a string representation of this Boolean.
*
* @param ptr The pointer to the field.
* @return a string representation of this Boolean.
*/
public java.lang.String toString(jnr.ffi.Pointer ptr) {
return java.lang.Boolean.toString(get(ptr));
}
}
/**
* A normal C boolean - 1 byte in size
*/
protected final class Boolean extends AbstractBoolean {
protected Boolean() {
super(NativeType.SCHAR);
}
protected Boolean(Offset offset) {
super(NativeType.SCHAR, offset);
}
public final boolean get(jnr.ffi.Pointer ptr) {
return (ptr.getByte(offset()) & 0x1) != 0;
}
public final void set(jnr.ffi.Pointer ptr, boolean value) {
ptr.putByte(offset(), (byte) (value ? 1 : 0));
}
}
/**
* A Windows BOOL - 4 bytes
*/
protected final class WBOOL extends AbstractBoolean {
protected WBOOL() {
super(NativeType.SINT);
}
protected WBOOL(Offset offset) {
super(NativeType.SINT, offset);
}
public final boolean get(jnr.ffi.Pointer ptr) {
return (ptr.getInt(offset()) & 0x1) != 0;
}
public final void set(jnr.ffi.Pointer ptr, boolean value) {
ptr.putInt(offset(), value ? 1 : 0);
}
}
/**
* Base class for all Number structure fields.
*/
protected abstract class NumberField extends Field {
protected final Type type;
protected NumberField(NativeType nativeType) {
this(getRuntime().findType(nativeType));
}
protected NumberField(Type type) {
super(addField(type));
this.type = type;
}
protected NumberField(NativeType nativeType, Offset offset) {
this(getRuntime().findType(nativeType), offset);
}
protected NumberField(Type type, Offset offset) {
super(addField(type, offset));
this.type = type;
}
/**
* Sets the field to a new value.
*
* @param ptr The pointer to the field.
* @param value The new value.
*/
public abstract void set(jnr.ffi.Pointer ptr, java.lang.Number value);
/**
* Returns an {@code float} representation of this Number.
*
* @param ptr The pointer to the field.
* @return an {@code float} value for this Number.
*/
public double doubleValue(jnr.ffi.Pointer ptr) {
return (double) longValue(ptr);
}
/**
* Returns an {@code float} representation of this Number.
*
* @param ptr The pointer to the field.
* @return an {@code float} value for this Number.
*/
public float floatValue(jnr.ffi.Pointer ptr) {
return (float) intValue(ptr);
}
/**
* Returns a {@code byte} representation of this Number.
*
* @param ptr The pointer to the field.
* @return a {@code byte} value for this Number.
*/
public byte byteValue(jnr.ffi.Pointer ptr) {
return (byte) intValue(ptr);
}
/**
* Returns a {@code short} representation of this Number.
*
* @param ptr The pointer to the field.
* @return a {@code short} value for this Number.
*/
public short shortValue(jnr.ffi.Pointer ptr) {
return (short) intValue(ptr);
}
/**
* Returns a {@code int} representation of this Number.
*
* @param ptr The pointer to the field.
* @return a {@code int} value for this Number.
*/
public abstract int intValue(jnr.ffi.Pointer ptr);
/**
* Returns a {@code long} representation of this Number.
*
* @param ptr The pointer to the field.
* @return a {@code long} value for this Number.
*/
public long longValue(jnr.ffi.Pointer ptr) {
return intValue(ptr);
}
/**
* Returns a string representation of this Number.
*
* @param ptr The pointer to the field.
* @return a string representation of this Number.
*/
public java.lang.String toString(jnr.ffi.Pointer ptr) {
return java.lang.Integer.toString(intValue(ptr), 10);
}
}
public abstract class IntegerAlias extends NumberField {
protected IntegerAlias(TypeAlias type) {
super(getRuntime().findType(type));
}
protected IntegerAlias(TypeAlias type, Offset offset) {
super(getRuntime().findType(type), offset);
}
@Override
public void set(jnr.ffi.Pointer ptr, Number value) {
ptr.putInt(type, offset(), value.longValue());
}
public void set(jnr.ffi.Pointer ptr, long value) {
ptr.putInt(type, offset(), value);
}
/**
* Gets the value for this field.
*
* @param ptr The pointer to the field.
* @return a long.
*/
public final long get(jnr.ffi.Pointer ptr) {
return ptr.getInt(type, offset());
}
@Override
public int intValue(jnr.ffi.Pointer ptr) {
return (int) get(ptr);
}
@Override
public long longValue(jnr.ffi.Pointer ptr) {
return get(ptr);
}
}
/**
* An 8 bit signed integer
*/
public class Signed8 extends NumberField {
/**
* Creates a new 8 bit integer field.
*/
public Signed8() {
super(NativeType.SCHAR);
}
/**
* Creates a new 8 bit integer field at a specific offset
*
* @param offset The offset within the memory area
*/
public Signed8(Offset offset) {
super(NativeType.SCHAR, offset);
}
/**
* Gets the value for this field.
*
* @param ptr The pointer to the field.
* @return a byte.
*/
public final byte get(jnr.ffi.Pointer ptr) {
return ptr.getByte(offset());
}
/**
* Sets the value for this field.
*
* @param ptr The memory to set the value in.
* @param value the 8 bit value to set.
*/
public final void set(jnr.ffi.Pointer ptr, byte value) {
ptr.putByte(offset(), value);
}
public void set(jnr.ffi.Pointer ptr, java.lang.Number value) {
ptr.putByte(offset(), value.byteValue());
}
/**
* Returns a java byte representation of this field.
*
* @return a java byte value for this field.
*/
@Override
public final byte byteValue(jnr.ffi.Pointer ptr) {
return get(ptr);
}
/**
* Returns a java short representation of this field.
*
* @return a java short value for this field.
*/
@Override
public final short shortValue(jnr.ffi.Pointer ptr) {
return get(ptr);
}
/**
* Returns a java int representation of this field.
*
* @return a java int value for this field.
*/
@Override
public final int intValue(jnr.ffi.Pointer ptr) {
return get(ptr);
}
}
/**
* An 8 bit unsigned integer
*/
public class Unsigned8 extends NumberField {
/**
* Creates a new 8 bit unsigned integer field.
*/
public Unsigned8() {
super(NativeType.UCHAR);
}
/**
* Creates a new 8 bit unsigned integer field at a specific offset
*
* @param offset The offset within the memory area for this field.
*/
public Unsigned8(Offset offset) {
super(NativeType.UCHAR, offset);
}
/**
* Gets the value for this field.
*
* @param ptr The pointer to the field.
* @return a byte.
*/
public final short get(jnr.ffi.Pointer ptr) {
short value = ptr.getByte(offset());
return value < 0 ? (short) ((value & 0x7F) + 0x80) : value;
}
/**
* Sets the value for this field.
*
* @param ptr The pointer to the field.
* @param value the 8 bit value to set.
*/
public final void set(jnr.ffi.Pointer ptr, short value) {
ptr.putByte(offset(), (byte) value);
}
public void set(jnr.ffi.Pointer ptr, java.lang.Number value) {
ptr.putByte(offset(), value.byteValue());
}
/**
* Returns a java short representation of this field.
*
* @return a java short value for this field.
*/
@Override
public final short shortValue(jnr.ffi.Pointer ptr) {
return get(ptr);
}
/**
* Returns a java int representation of this field.
*
* @return a java int value for this field.
*/
@Override
public final int intValue(jnr.ffi.Pointer ptr) {
return get(ptr);
}
}
/**
* A 16 bit signed integer field.
*/
public class Signed16 extends NumberField {
/**
* Creates a new 16 bit integer field.
*/
public Signed16() {
super(NativeType.SSHORT);
}
/**
* Creates a new 16 bit signed integer field at a specific offset
*
* @param offset The offset within the memory area for this field.
*/
public Signed16(Offset offset) {
super(NativeType.SSHORT, offset);
}
/**
* Gets the value for this field.
*
* @param ptr The pointer to the field.
* @return a short.
*/
public final short get(jnr.ffi.Pointer ptr) {
return ptr.getShort(offset());
}
/**
* Sets the value for this field.
*
* @param ptr The pointer to the field.
* @param value the 16 bit value to set.
*/
public final void set(jnr.ffi.Pointer ptr, short value) {
ptr.putShort(offset(), value);
}
public void set(jnr.ffi.Pointer ptr, java.lang.Number value) {
ptr.putShort(offset(), value.shortValue());
}
/**
* Returns a java short representation of this field.
*
* @return a java short value for this field.
*/
@Override
public final short shortValue(jnr.ffi.Pointer ptr) {
return get(ptr);
}
/**
* Returns a java int representation of this field.
*
* @return a java int value for this field.
*/
@Override
public final int intValue(jnr.ffi.Pointer ptr) {
return get(ptr);
}
}
/**
* A 16 bit signed integer field.
*/
public class Unsigned16 extends NumberField {
/**
* Creates a new 16 bit integer field.
*/
public Unsigned16() {
super(NativeType.USHORT);
}
/**
* Creates a new 16 bit unsigned integer field at a specific offset
*
* @param offset The offset within the memory area for this field.
*/
public Unsigned16(Offset offset) {
super(NativeType.USHORT, offset);
}
/**
* Gets the value for this field.
*
* @param ptr The pointer to the field.
* @return a short.
*/
public final int get(jnr.ffi.Pointer ptr) {
int value = ptr.getShort(offset());
return value < 0 ? (int)((value & 0x7FFF) + 0x8000) : value;
}
/**
* Sets the value for this field.
*
* @param ptr The pointer to the field.
* @param value the 16 bit unsigned value to set.
*/
public final void set(jnr.ffi.Pointer ptr, int value) {
ptr.putShort(offset(), (short) value);
}
public void set(jnr.ffi.Pointer ptr, Number value) {
ptr.putShort(offset(), value.shortValue());
}
/**
* Returns a java int representation of this field.
*
* @param ptr The pointer to the field.
* @return a java int value for this field.
*/
@Override
public final int intValue(jnr.ffi.Pointer ptr) {
return get(ptr);
}
}
/**
* A 32 bit signed integer field.
*/
public class Signed32 extends NumberField {
/**
* Creates a new 32 bit integer field.
*/
public Signed32() {
super(NativeType.SINT);
}
/**
* Creates a new 32 bit signed integer field at a specific offset
*
* @param offset The offset within the memory area for this field.
*/
public Signed32(Offset offset) {
super(NativeType.SINT, offset);
}
/**
* Gets the value for this field.
*
* @param ptr The pointer to the field.
* @return a int.
*/
public final int get(jnr.ffi.Pointer ptr) {
return ptr.getInt(offset());
}
/**
* Sets the value for this field.
*
* @param ptr The pointer to the field.
* @param value the 32 bit value to set.
*/
public final void set(jnr.ffi.Pointer ptr, int value) {
ptr.putInt(offset(), value);
}
public void set(jnr.ffi.Pointer ptr, java.lang.Number value) {
ptr.putInt(offset(), value.intValue());
}
/**
* Returns a java int representation of this field.
*
* @param ptr The pointer to the field.
* @return a java int value for this field.
*/
@Override
public final int intValue(jnr.ffi.Pointer ptr) {
return get(ptr);
}
}
/**
* A 32 bit signed integer field.
*/
public class Unsigned32 extends NumberField {
/**
* Creates a new 32 bit integer field.
*/
public Unsigned32() {
super(NativeType.UINT);
}
/**
* Creates a new 32 bit unsigned integer field at a specific offset
*
* @param offset The offset within the memory area for this field.
*/
public Unsigned32(Offset offset) {
super(NativeType.SINT, offset);
}
/**
* Gets the value for this field.
*
* @param ptr The pointer to the field.
* @return a long.
*/
public final long get(jnr.ffi.Pointer ptr) {
long value = ptr.getInt(offset());
return value < 0 ? (long)((value & 0x7FFFFFFFL) + 0x80000000L) : value;
}
/**
* Sets the value for this field.
*
* @param ptr The pointer to the field.
* @param value the 32 bit unsigned value to set.
*/
public final void set(jnr.ffi.Pointer ptr, long value) {
ptr.putInt(offset(), (int) value);
}
public void set(jnr.ffi.Pointer ptr, java.lang.Number value) {
ptr.putInt(offset(), value.intValue());
}
/**
* Returns a java int representation of this field.
*
* @param ptr The pointer to the field.
* @return a java int value for this field.
*/
@Override
public final int intValue(jnr.ffi.Pointer ptr) {
return (int) get(ptr);
}
/**
* Returns a java long representation of this field.
*
* @param ptr The pointer to the field.
* @return a java long value for this field.
*/
@Override
public final long longValue(jnr.ffi.Pointer ptr) {
return get(ptr);
}
}
/**
* A 64 bit signed integer field.
*/
public class Signed64 extends NumberField {
/**
* Creates a new 64 bit integer field.
*/
public Signed64() {
super(NativeType.SLONGLONG);
}
/**
* Creates a new 64 bit signed integer field at a specific offset
*
* @param offset The offset within the memory area for this field.
*/
public Signed64(Offset offset) {
super(NativeType.SLONGLONG, offset);
}
/**
* Gets the value for this field.
*
* @param ptr The pointer to the field.
* @return a long.
*/
public final long get(jnr.ffi.Pointer ptr) {
return ptr.getLongLong(offset());
}
/**
* Sets the value for this field.
*
* @param ptr The pointer to the field.
* @param value the 64 bit value to set.
*/
public final void set(jnr.ffi.Pointer ptr, long value) {
ptr.putLongLong(offset(), value);
}
public void set(jnr.ffi.Pointer ptr, java.lang.Number value) {
ptr.putLongLong(offset(), value.longValue());
}
/**
* Returns a java int representation of this field.
*
* @param ptr The pointer to the field.
* @return a java int value for this field.
*/
@Override
public final int intValue(jnr.ffi.Pointer ptr) {
return (int) get(ptr);
}
/**
* Returns a java long representation of this field.
*
* @param ptr The pointer to the field.
* @return a java long value for this field.
*/
@Override
public final long longValue(jnr.ffi.Pointer ptr) {
return get(ptr);
}
/**
* Returns a string representation of this field.
*
* @param ptr The pointer to the field.
* @return a string representation of this field.
*/
@Override
public final java.lang.String toString(jnr.ffi.Pointer ptr) {
return java.lang.Long.toString(get(ptr));
}
}
/**
* A 64 bit unsigned integer field.
*/
public class Unsigned64 extends NumberField {
/**
* Creates a new 64 bit integer field.
*/
public Unsigned64() {
super(NativeType.ULONGLONG);
}
/**
* Creates a new 64 bit unsigned integer field at a specific offset
*
* @param offset The offset within the memory area for this field.
*/
public Unsigned64(Offset offset) {
super(NativeType.ULONGLONG, offset);
}
/**
* Gets the value for this field.
*
* @param ptr The pointer to the field.
* @return a long.
*/
public final long get(jnr.ffi.Pointer ptr) {
return ptr.getLongLong(offset());
}
/**
* Sets the value for this field.
*
* @param ptr The pointer to the field.
* @param value the 64 bit value to set.
*/
public final void set(jnr.ffi.Pointer ptr, long value) {
ptr.putLongLong(offset(), value);
}
public void set(jnr.ffi.Pointer ptr, java.lang.Number value) {
ptr.putLongLong(offset(), value.longValue());
}
/**
* Returns a java int representation of this field.
*
* @param ptr The pointer to the field.
* @return a java int value for this field.
*/
@Override
public final int intValue(jnr.ffi.Pointer ptr) {
return (int) get(ptr);
}
/**
* Returns a java long representation of this field.
*
* @param ptr The pointer to the field.
* @return a java long value for this field.
*/
@Override
public final long longValue(jnr.ffi.Pointer ptr) {
return get(ptr);
}
/**
* Returns a string representation of this field.
*
* @param ptr The pointer to the field.
* @return a string representation of this field.
*/
@Override
public final java.lang.String toString(jnr.ffi.Pointer ptr) {
return java.lang.Long.toString(get(ptr));
}
}
/**
* A native long integer field.
*/
public class SignedLong extends NumberField {
/**
* Creates a new native long field.
*/
public SignedLong() {
super(NativeType.SLONG);
}
/**
* Creates a new signed native long field at a specific offset
*
* @param offset The offset within the memory area for this field.
*/
public SignedLong(Offset offset) {
super(NativeType.SLONG, offset);
}
/**
* Gets the value for this field.
*
* @param ptr The pointer to the field.
* @return a long.
*/
public final long get(jnr.ffi.Pointer ptr) {
return ptr.getNativeLong(offset());
}
/**
* Sets the value for this field.
*
* @param ptr The pointer to the field.
* @param value the 32/64 bit value to set.
*/
public final void set(jnr.ffi.Pointer ptr, long value) {
ptr.putNativeLong(offset(), value);
}
public void set(jnr.ffi.Pointer ptr, java.lang.Number value) {
ptr.putNativeLong(offset(), value.longValue());
}
/**
* Returns a java int representation of this field.
*
* @param ptr The pointer to the field.
* @return a java int value for this field.
*/
@Override
public final int intValue(jnr.ffi.Pointer ptr) {
return (int) get(ptr);
}
/**
* Returns a java long representation of this field.
*
* @param ptr The pointer to the field.
* @return a java long value for this field.
*/
@Override
public final long longValue(jnr.ffi.Pointer ptr) {
return get(ptr);
}
/**
* Returns a string representation of this field.
*
* @param ptr The pointer to the field.
* @return a string representation of this field.
*/
@Override
public final java.lang.String toString(jnr.ffi.Pointer ptr) {
return java.lang.Long.toString(get(ptr));
}
}
/**
* A native long integer field.
*/
public class UnsignedLong extends NumberField {
/**
* Creates a new native long field.
*/
public UnsignedLong() {
super(NativeType.ULONG);
}
/**
* Creates a new unsigned native long field at a specific offset
*
* @param offset The offset within the memory area for this field.
*/
public UnsignedLong(Offset offset) {
super(NativeType.ULONG, offset);
}
/**
* Gets the value for this field.
*
* @param ptr The pointer to the field.
* @return a int.
*/
public final long get(jnr.ffi.Pointer ptr) {
long value = ptr.getNativeLong(offset());
final long mask = getRuntime().findType(NativeType.SLONG).size() == 4 ? 0xffffffffL : 0xffffffffffffffffL;
return value < 0
? (long) ((value & mask) + mask + 1)
: value;
}
/**
* Sets the value for this field.
*
* @param ptr The pointer to the field.
* @param value the 32/64 bit value to set.
*/
public final void set(jnr.ffi.Pointer ptr, long value) {
ptr.putNativeLong(offset(), value);
}
public void set(jnr.ffi.Pointer ptr, java.lang.Number value) {
ptr.putNativeLong(offset(), value.longValue());
}
/**
* Returns a java int representation of this field.
*
* @return a java int value for this field.
*/
@Override
public final int intValue(jnr.ffi.Pointer ptr) {
return (int) get(ptr);
}
/**
* Returns a java long representation of this field.
*
* @return a java long value for this field.
*/
@Override
public final long longValue(jnr.ffi.Pointer ptr) {
return get(ptr);
}
/**
* Returns a string representation of this field.
*
* @return a string representation of this field.
*/
@Override
public final java.lang.String toString(jnr.ffi.Pointer ptr) {
return java.lang.Long.toString(get(ptr));
}
}
public class Float extends NumberField {
public Float() {
super(NativeType.FLOAT);
}
/**
* Creates a new float field at a specific offset
*
* @param offset The offset within the memory area for this field.
*/
public Float(Offset offset) {
super(NativeType.FLOAT, offset);
}
public final float get(jnr.ffi.Pointer ptr) {
return ptr.getFloat(offset());
}
public final void set(jnr.ffi.Pointer ptr, float value) {
ptr.putFloat(offset(), value);
}
public void set(jnr.ffi.Pointer ptr, java.lang.Number value) {
ptr.putFloat(offset(), value.floatValue());
}
@Override
public final int intValue(jnr.ffi.Pointer ptr) {
return (int) get(ptr);
}
@Override
public final double doubleValue(jnr.ffi.Pointer ptr) {
return get(ptr);
}
@Override
public final float floatValue(jnr.ffi.Pointer ptr) {
return get(ptr);
}
@Override
public final long longValue(jnr.ffi.Pointer ptr) {
return (long) get(ptr);
}
@Override
public final java.lang.String toString(jnr.ffi.Pointer ptr) {
return java.lang.String.valueOf(get(ptr));
}
}
public final class Double extends NumberField {
public Double() {
super(NativeType.DOUBLE);
}
public Double(Offset offset) {
super(NativeType.DOUBLE, offset);
}
public final double get(jnr.ffi.Pointer ptr) {
return ptr.getDouble(offset());
}
public final void set(jnr.ffi.Pointer ptr, double value) {
ptr.putDouble(offset(), value);
}
public void set(jnr.ffi.Pointer ptr, java.lang.Number value) {
ptr.putDouble(offset(), value.doubleValue());
}
@Override
public final int intValue(jnr.ffi.Pointer ptr) {
return (int) get(ptr);
}
@Override
public final long longValue(jnr.ffi.Pointer ptr) {
return (long) get(ptr);
}
@Override
public final float floatValue(jnr.ffi.Pointer ptr) {
return (float) get(ptr);
}
@Override
public final double doubleValue(jnr.ffi.Pointer ptr) {
return get(ptr);
}
@Override
public final java.lang.String toString(jnr.ffi.Pointer ptr) {
return java.lang.String.valueOf(get(ptr));
}
}
/**
* Represents a native memory address.
*/
public class Pointer extends NumberField {
/**
* Creates a new Address field.
*/
public Pointer() {
super(NativeType.ADDRESS);
}
public Pointer(Offset offset) {
super(NativeType.ADDRESS, offset);
}
/**
* Gets the {@link jnr.ffi.Pointer} value from the native memory.
*
* @param ptr The pointer to the field.
* @return a {@link jnr.ffi.Pointer}.
*/
public final jnr.ffi.Pointer get(jnr.ffi.Pointer ptr) {
return ptr.getPointer(offset());
}
/**
* Gets the size of a Pointer in bits
*
* @return the size of the Pointer
*/
public final int size() {
return getRuntime().findType(NativeType.ADDRESS).size();
}
/**
* Sets a {@link jnr.ffi.Pointer} value in the native memory.
*
* @param ptr The pointer to the write location.
* @param value The value to set.
*/
public final void set(jnr.ffi.Pointer ptr, jnr.ffi.Pointer value) {
ptr.putPointer(offset(), value);
}
public void set(jnr.ffi.Pointer ptr, java.lang.Number value) {
ptr.putAddress(offset(), value.longValue());
}
/**
* Returns an integer representation of this Pointer.
*
* @return an integer value for this Pointer.
*/
@Override
public final int intValue(jnr.ffi.Pointer ptr) {
return (int) ptr.getAddress(offset());
}
/**
* Returns an {@code long} representation of this Pointer.
*
* @return an {@code long} value for this Pointer.
*/
@Override
public final long longValue(jnr.ffi.Pointer ptr) {
return ptr.getAddress(offset());
}
/**
* Returns a string representation of this Pointer.
*
* @return a string representation of this Pointer.
*/
@Override
public final java.lang.String toString(jnr.ffi.Pointer ptr) {
return get(ptr).toString();
}
}
/**
* Base for all the Enum fields.
*
* @param the type of {@link java.lang.Enum}
*/
protected abstract class EnumField> extends NumberField {
protected final Class enumClass;
protected final EnumMapper enumMapper;
/**
* Constructs a new Enum field.
*
* @param type the native type of the enum.
* @param enumClass the Enum class.
*/
public EnumField(NativeType type, Class enumClass) {
super(type);
this.enumClass = enumClass;
this.enumMapper = EnumMapper.getInstance(enumClass);
}
/**
* Constructs a new Enum field.
*
* @param type the native type of the enum.
* @param enumClass the Enum class.
* @param offset the offset.
*/
public EnumField(NativeType type, Class enumClass, Offset offset) {
super(type, offset);
this.enumClass = enumClass;
this.enumMapper = EnumMapper.getInstance(enumClass);
}
/**
* Gets a java Enum value representing the native integer value.
*
* @param ptr The pointer to the field.
* @return a java Enum value.
*/
public E get(jnr.ffi.Pointer ptr) {
return enumClass.cast(enumMapper.valueOf(intValue(ptr)));
}
/**
* Returns a string representation of this field.
*
* @param ptr The pointer to the field.
* @return a string representation of this field.
*/
@Override
public final java.lang.String toString(jnr.ffi.Pointer ptr) {
return get(ptr).toString();
}
}
/**
* An 8 bit enum field.
*
* @param the {@link java.lang.Enum} to translate to/from.
*/
public class Enum8> extends EnumField {
/**
* Creates a new 8 bit enum field.
*
* @param enumClass the class of the {@link java.lang.Enum}.
*/
public Enum8(Class enumClass) {
super(NativeType.SCHAR, enumClass);
}
/**
* Creates a new 8 bit enum field.
*
* @param enumClass the class of the {@link java.lang.Enum}.
* @param offset the offset of the enum field.
*/
public Enum8(Class enumClass, Offset offset) {
super(NativeType.SCHAR, enumClass, offset);
}
/**
* Sets the native integer value using a java Enum value.
*
* @param ptr The pointer to the field.
* @param value the java Enum value.
*/
public final void set(jnr.ffi.Pointer ptr, E value) {
ptr.putByte(offset(), (byte) enumMapper.intValue(value));
}
public void set(jnr.ffi.Pointer ptr, java.lang.Number value) {
ptr.putByte(offset(), value.byteValue());
}
/**
* Returns an integer representation of this enum field.
*
* @return an integer value for this enum field.
*/
@Override
public final int intValue(jnr.ffi.Pointer ptr) {
return ptr.getByte(offset());
}
}
public class Enum16> extends EnumField {
public Enum16(Class enumClass) {
super(NativeType.SSHORT, enumClass);
}
public Enum16(Class enumClass, Offset offset) {
super(NativeType.SSHORT, enumClass, offset);
}
public void set(jnr.ffi.Pointer ptr, E value) {
ptr.putShort(offset(), (short) enumMapper.intValue(value));
}
public void set(jnr.ffi.Pointer ptr, java.lang.Number value) {
ptr.putShort(offset(), value.shortValue());
}
@Override
public final int intValue(jnr.ffi.Pointer ptr) {
return ptr.getShort(offset());
}
}
public class Enum32> extends EnumField {
public Enum32(Class enumClass) {
super(NativeType.SINT, enumClass);
}
public Enum32(Class enumClass, Offset offset) {
super(NativeType.SINT, enumClass, offset);
}
public void set(jnr.ffi.Pointer ptr, E value) {
ptr.putInt(offset(), enumMapper.intValue(value));
}
public void set(jnr.ffi.Pointer ptr, java.lang.Number value) {
ptr.putInt(offset(), value.intValue());
}
@Override
public final int intValue(jnr.ffi.Pointer ptr) {
return ptr.getInt(offset());
}
}
public class Enum64> extends EnumField {
public Enum64(Class enumClass) {
super(NativeType.SLONGLONG, enumClass);
}
public Enum64(Class enumClass, Offset offset) {
super(NativeType.SLONGLONG, enumClass, offset);
}
public final void set(jnr.ffi.Pointer ptr, E value) {
ptr.putLongLong(offset(), enumMapper.intValue(value));
}
public void set(jnr.ffi.Pointer ptr, java.lang.Number value) {
ptr.putLongLong(offset(), value.longValue());
}
@Override
public final int intValue(jnr.ffi.Pointer ptr) {
return (int) longValue(ptr);
}
@Override
public final long longValue(jnr.ffi.Pointer ptr) {
return ptr.getLongLong(offset());
}
}
public class EnumLong> extends EnumField {
public EnumLong(Class enumClass) {
super(NativeType.SLONG, enumClass);
}
public EnumLong(Class enumClass, Offset offset) {
super(NativeType.SLONG, enumClass, offset);
}
public final void set(jnr.ffi.Pointer ptr, E value) {
ptr.putNativeLong(offset(), enumMapper.intValue(value));
}
public void set(jnr.ffi.Pointer ptr, java.lang.Number value) {
ptr.putNativeLong(offset(), value.longValue());
}
@Override
public final int intValue(jnr.ffi.Pointer ptr) {
return (int) longValue(ptr);
}
@Override
public final long longValue(jnr.ffi.Pointer ptr) {
return ptr.getNativeLong(offset());
}
}
public class Enum> extends Enum32 {
public Enum(Class enumClass) {
super(enumClass);
}
public Enum(Class enumClass, Offset offset) {
super(enumClass, offset);
}
}
abstract public class String extends AbstractField {
protected final Charset charset;
protected final int length;
protected String(int size, int align, int length, Charset cs) {
super(size, align);
this.length = length;
this.charset = cs;
}
protected String(int size, int align, Offset offset, int length, Charset cs) {
super(size, align, offset);
this.length = length;
this.charset = cs;
}
public final int length() {
return length;
}
protected abstract jnr.ffi.Pointer getStringMemory(jnr.ffi.Pointer ptr);
public abstract java.lang.String get(jnr.ffi.Pointer ptr);
public abstract void set(jnr.ffi.Pointer ptr, java.lang.String value);
public final java.lang.String toString(jnr.ffi.Pointer ptr) {
return get(ptr);
}
}
public class UTFString extends String {
public UTFString(int length, Charset cs) {
super(length, 1, length, cs); // FIXME: This won't work for non-ASCII
}
public UTFString(int length, Charset cs, Offset offset) {
super(length, 1, offset, length, cs); // FIXME: This won't work for non-ASCII
}
protected jnr.ffi.Pointer getStringMemory(jnr.ffi.Pointer ptr) {
return ptr.slice(offset(), length());
}
public final java.lang.String get(jnr.ffi.Pointer ptr) {
return getStringMemory(ptr).getString(0, length, charset);
}
public final void set(jnr.ffi.Pointer ptr, java.lang.String value) {
getStringMemory(ptr).putString(0, value, length, charset);
}
}
public class UTF8String extends UTFString {
public UTF8String(int size) {
super(size, UTF8);
}
public UTF8String(int size, Offset offset) {
super(size, UTF8, offset);
}
}
public class AsciiString extends UTFString {
public AsciiString(int size) {
super(size, ASCII);
}
public AsciiString(int size, Offset offset) {
super(size, ASCII, offset);
}
}
public class UTFStringRef extends String {
private jnr.ffi.Pointer valueHolder;
public UTFStringRef(int length, Charset cs) {
super(getRuntime().findType(NativeType.ADDRESS).size(), getRuntime().findType(NativeType.ADDRESS).alignment(),
length, cs);
}
public UTFStringRef(int length, Charset cs, Offset offset) {
super(getRuntime().findType(NativeType.ADDRESS).size(), getRuntime().findType(NativeType.ADDRESS).alignment(),
offset, length, cs);
}
public UTFStringRef(Charset cs) {
this(Integer.MAX_VALUE, cs);
}
protected jnr.ffi.Pointer getStringMemory(jnr.ffi.Pointer ptr) {
return ptr.getPointer(offset(), length());
}
public final java.lang.String get(jnr.ffi.Pointer ptr) {
jnr.ffi.Pointer memory = getStringMemory(ptr);
return memory != null ? memory.getString(0, length, charset) : null;
}
public final void set(jnr.ffi.Pointer ptr, java.lang.String value) {
if (value != null) {
valueHolder = getRuntime().getMemoryManager().allocateDirect(length() * 4);
valueHolder.putString(0, value, length() * 4, charset);
ptr.putPointer(offset(), valueHolder);
} else {
this.valueHolder = null;
ptr.putAddress(offset(), 0);
}
}
}
public class UTF8StringRef extends UTFStringRef {
public UTF8StringRef(int size) {
super(size, UTF8);
}
public UTF8StringRef(int size, Offset offset) {
super(size, UTF8, offset);
}
public UTF8StringRef() {
super(Integer.MAX_VALUE, UTF8);
}
}
public class AsciiStringRef extends UTFStringRef {
public AsciiStringRef(int size) {
super(size, ASCII);
}
public AsciiStringRef(int size, Offset offset) {
super(size, ASCII, offset);
}
public AsciiStringRef() {
super(Integer.MAX_VALUE, ASCII);
}
}
/**
* Specialized padding fields for structs. Use this instead of arrays of other
* members for more efficient struct construction.
*/
protected final class Padding extends AbstractField {
public Padding(Type type, int length) {
super(type.size() * length, type.alignment());
}
public Padding(Type type, int length, Offset offset) {
super(type.size() * length, type.alignment(), offset);
}
public Padding(NativeType type, int length) {
this(getRuntime().findType(type), length);
}
public Padding(NativeType type, int length, Offset offset) {
this(getRuntime().findType(type), length);
}
}
protected final class Function extends AbstractField {
private final Class closureClass;
private T instance;
public Function(Class closureClass) {
super(NativeType.ADDRESS);
this.closureClass = closureClass;
}
public Function(Class closureClass, Offset offset) {
super(NativeType.ADDRESS, offset);
this.closureClass = closureClass;
}
public final void set(jnr.ffi.Pointer ptr, T value) {
ptr.putPointer(offset(), getRuntime().getClosureManager().getClosurePointer(closureClass, instance = value));
}
}
protected final Function function(Class closureClass) {
return new Function(closureClass);
}
protected final Function function(Class closureClass, Offset offset) {
return new Function(closureClass, offset);
}
public final class int8_t extends IntegerAlias {
public int8_t() { super(TypeAlias.int8_t); }
public int8_t(Offset offset) { super(TypeAlias.int8_t, offset); }
}
public final class u_int8_t extends IntegerAlias {
public u_int8_t() { super(TypeAlias.u_int8_t); }
public u_int8_t(Offset offset) { super(TypeAlias.u_int8_t, offset); }
}
public final class int16_t extends IntegerAlias {
public int16_t() { super(TypeAlias.int16_t); }
public int16_t(Offset offset) { super(TypeAlias.int16_t, offset); }
}
public final class u_int16_t extends IntegerAlias {
public u_int16_t() { super(TypeAlias.u_int16_t); }
public u_int16_t(Offset offset) { super(TypeAlias.u_int16_t, offset); }
}
public final class int32_t extends IntegerAlias {
public int32_t() { super(TypeAlias.int32_t); }
public int32_t(Offset offset) { super(TypeAlias.int32_t, offset); }
}
public final class u_int32_t extends IntegerAlias {
public u_int32_t() { super(TypeAlias.u_int32_t); }
public u_int32_t(Offset offset) { super(TypeAlias.u_int32_t, offset); }
}
public final class int64_t extends IntegerAlias {
public int64_t() { super(TypeAlias.int64_t); }
public int64_t(Offset offset) { super(TypeAlias.int64_t, offset); }
}
public final class u_int64_t extends IntegerAlias {
public u_int64_t() { super(TypeAlias.u_int64_t); }
public u_int64_t(Offset offset) { super(TypeAlias.u_int64_t, offset); }
}
public final class intptr_t extends IntegerAlias {
public intptr_t() { super(TypeAlias.intptr_t); }
public intptr_t(Offset offset) { super(TypeAlias.intptr_t, offset); }
}
public final class uintptr_t extends IntegerAlias {
public uintptr_t() { super(TypeAlias.uintptr_t); }
public uintptr_t(Offset offset) { super(TypeAlias.uintptr_t, offset); }
}
public final class caddr_t extends IntegerAlias {
public caddr_t() { super(TypeAlias.caddr_t); }
public caddr_t(Offset offset) { super(TypeAlias.caddr_t, offset); }
}
public final class dev_t extends IntegerAlias {
public dev_t() { super(TypeAlias.dev_t); }
public dev_t(Offset offset) { super(TypeAlias.dev_t, offset); }
}
public final class blkcnt_t extends IntegerAlias {
public blkcnt_t() { super(TypeAlias.blkcnt_t); }
public blkcnt_t(Offset offset) { super(TypeAlias.blkcnt_t, offset); }
}
public final class blksize_t extends IntegerAlias {
public blksize_t() { super(TypeAlias.blksize_t); }
public blksize_t(Offset offset) { super(TypeAlias.blksize_t, offset); }
}
public final class gid_t extends IntegerAlias {
public gid_t() { super(TypeAlias.gid_t); }
public gid_t(Offset offset) { super(TypeAlias.gid_t, offset); }
}
public final class in_addr_t extends IntegerAlias {
public in_addr_t() { super(TypeAlias.in_addr_t); }
public in_addr_t(Offset offset) { super(TypeAlias.in_addr_t, offset); }
}
public final class in_port_t extends IntegerAlias {
public in_port_t() { super(TypeAlias.in_port_t); }
public in_port_t(Offset offset) { super(TypeAlias.in_port_t, offset); }
}
public final class ino_t extends IntegerAlias {
public ino_t() { super(TypeAlias.ino_t); }
public ino_t(Offset offset) { super(TypeAlias.ino_t, offset); }
}
public final class ino64_t extends IntegerAlias {
public ino64_t() { super(TypeAlias.ino64_t); }
public ino64_t(Offset offset) { super(TypeAlias.ino64_t, offset); }
}
public final class key_t extends IntegerAlias {
public key_t() { super(TypeAlias.key_t); }
public key_t(Offset offset) { super(TypeAlias.key_t, offset); }
}
public final class mode_t extends IntegerAlias {
public mode_t() { super(TypeAlias.mode_t); }
public mode_t(Offset offset) { super(TypeAlias.mode_t, offset); }
}
public final class nlink_t extends IntegerAlias {
public nlink_t() { super(TypeAlias.nlink_t); }
public nlink_t(Offset offset) { super(TypeAlias.nlink_t, offset); }
}
public final class id_t extends IntegerAlias {
public id_t() { super(TypeAlias.id_t); }
public id_t(Offset offset) { super(TypeAlias.id_t, offset); }
}
public final class pid_t extends IntegerAlias {
public pid_t() { super(TypeAlias.pid_t); }
public pid_t(Offset offset) { super(TypeAlias.pid_t, offset); }
}
public final class off_t extends IntegerAlias {
public off_t() { super(TypeAlias.off_t); }
public off_t(Offset offset) { super(TypeAlias.off_t, offset); }
}
public final class swblk_t extends IntegerAlias {
public swblk_t() { super(TypeAlias.swblk_t); }
public swblk_t(Offset offset) { super(TypeAlias.swblk_t, offset); }
}
public final class uid_t extends IntegerAlias {
public uid_t() { super(TypeAlias.uid_t); }
public uid_t(Offset offset) { super(TypeAlias.uid_t, offset); }
}
public final class clock_t extends IntegerAlias {
public clock_t() { super(TypeAlias.clock_t); }
public clock_t(Offset offset) { super(TypeAlias.clock_t, offset); }
}
public final class size_t extends IntegerAlias {
public size_t() { super(TypeAlias.size_t); }
public size_t(Offset offset) { super(TypeAlias.size_t, offset); }
}
public final class ssize_t extends IntegerAlias {
public ssize_t() { super(TypeAlias.ssize_t); }
public ssize_t(Offset offset) { super(TypeAlias.ssize_t, offset); }
}
public final class time_t extends IntegerAlias {
public time_t() { super(TypeAlias.time_t); }
public time_t(Offset offset) { super(TypeAlias.time_t, offset); }
}
public final class fsblkcnt_t extends IntegerAlias {
public fsblkcnt_t() { super(TypeAlias.fsblkcnt_t); }
public fsblkcnt_t(Offset offset) { super(TypeAlias.fsblkcnt_t, offset); }
}
public final class fsfilcnt_t extends IntegerAlias {
public fsfilcnt_t() { super(TypeAlias.fsfilcnt_t); }
public fsfilcnt_t(Offset offset) { super(TypeAlias.fsfilcnt_t, offset); }
}
public final class sa_family_t extends IntegerAlias {
public sa_family_t() { super(TypeAlias.sa_family_t); }
public sa_family_t(Offset offset) { super(TypeAlias.sa_family_t, offset); }
}
public final class socklen_t extends IntegerAlias {
public socklen_t() { super(TypeAlias.socklen_t); }
public socklen_t(Offset offset) { super(TypeAlias.socklen_t, offset); }
}
public final class rlim_t extends IntegerAlias {
public rlim_t() { super(TypeAlias.rlim_t); }
public rlim_t(Offset offset) { super(TypeAlias.rlim_t, offset); }
}
}