Package org.lwjgl.glfw

Class GLFWReallocateCallback

java.lang.Object
org.lwjgl.system.Callback
org.lwjgl.glfw.GLFWReallocateCallback
All Implemented Interfaces:
AutoCloseable, GLFWReallocateCallbackI, org.lwjgl.system.CallbackI, org.lwjgl.system.NativeResource, org.lwjgl.system.Pointer
public abstract class GLFWReallocateCallback extends org.lwjgl.system.Callback implements GLFWReallocateCallbackI
The function pointer type for memory reallocation callbacks.

This is the function pointer type for memory reallocation callbacks. A memory reallocation callback function has the following signature:


 void* function_name(void* block, size_t size, void* user)

This function must return a memory block at least size bytes long, or NULL if allocation failed. Note that not all parts of GLFW handle allocation failures gracefully yet.

This function may be called during Init but before the library is flagged as initialized, as well as during Terminate after the library is no longer flagged as initialized.

Any memory allocated by this function will be deallocated during library termination or earlier.

The block address will never be NULL and the size will always be greater than zero. Reallocations of a block to size zero are converted into deallocations. Reallocations of NULL to a non-zero size are converted into regular allocations.

Note
  • The returned memory block must be valid at least until it is deallocated.
  • This function should not call any GLFW function.
  • This function may be called from any thread that calls GLFW functions.

Type


 void * (*GLFWReallocateCallbackI.invoke(long, long, long)) (
     void *block,
     size_t size,
     void *user
 )
Since:
version 3.4

  • Nested Class Summary

    Nested classes/interfaces inherited from interface org.lwjgl.system.Pointer

    org.lwjgl.system.Pointer.Default

  • Field Summary

    Fields inherited from interface org.lwjgl.glfw.GLFWReallocateCallbackI

    CIF

    Fields inherited from interface org.lwjgl.system.Pointer

    BITS32, BITS64, CLONG_SHIFT, CLONG_SIZE, POINTER_SHIFT, POINTER_SIZE

  • Method Summary

    Modifier and Type
    Method
    Description
    static GLFWReallocateCallback
    create(long functionPointer)
    Creates a GLFWReallocateCallback instance from the specified function pointer.
    static GLFWReallocateCallback
    create(GLFWReallocateCallbackI instance)
    Creates a GLFWReallocateCallback instance that delegates to the specified GLFWReallocateCallbackI instance.
    static GLFWReallocateCallback
    createSafe(long functionPointer)
    Like create, but returns null if functionPointer is NULL.

    Methods inherited from class org.lwjgl.system.Callback

    address, equals, free, free, get, getSafe, hashCode, toString

    Methods inherited from class java.lang.Object

    getClass, notify, notifyAll, wait, wait, wait

    Methods inherited from interface org.lwjgl.system.CallbackI

    address

    Methods inherited from interface org.lwjgl.glfw.GLFWReallocateCallbackI

    callback, getCallInterface, invoke

    Methods inherited from interface org.lwjgl.system.NativeResource

    close

  • Method Details

    • create

      public static GLFWReallocateCallback create(long functionPointer)
      Creates a GLFWReallocateCallback instance from the specified function pointer.
      Returns:
      the new GLFWReallocateCallback

    • createSafe

      @Nullable public static GLFWReallocateCallback createSafe(long functionPointer)
      Like create, but returns null if functionPointer is NULL.

    • create

      public static GLFWReallocateCallback create(GLFWReallocateCallbackI instance)
      Creates a GLFWReallocateCallback instance that delegates to the specified GLFWReallocateCallbackI instance.