Package org.lwjgl.system.libc

Class LibCStdlib

java.lang.Object

org.lwjgl.system.libc.LibCStdlib

public class LibCStdlib
extends java.lang.Object

Native bindings to stdlib.h.

Method Summary

Modifier and Type	Method and Description
static java.nio.ByteBuffer	aligned_alloc(long alignment, long size) Allocates size bytes of uninitialized storage whose alignment is specified by alignment.
static void	aligned_free(java.nio.ByteBuffer ptr) Frees a block of memory that was allocated with LibCStdlib.aligned_alloc(long, long).
static void	aligned_free(java.nio.DoubleBuffer ptr) Frees a block of memory that was allocated with LibCStdlib.aligned_alloc(long, long).
static void	aligned_free(java.nio.FloatBuffer ptr) Frees a block of memory that was allocated with LibCStdlib.aligned_alloc(long, long).
static void	aligned_free(java.nio.IntBuffer ptr) Frees a block of memory that was allocated with LibCStdlib.aligned_alloc(long, long).
static void	aligned_free(java.nio.LongBuffer ptr) Frees a block of memory that was allocated with LibCStdlib.aligned_alloc(long, long).
static void	aligned_free(PointerBuffer ptr) Frees a block of memory that was allocated with LibCStdlib.aligned_alloc(long, long).
static void	aligned_free(java.nio.ShortBuffer ptr) Frees a block of memory that was allocated with LibCStdlib.aligned_alloc(long, long).
static java.nio.ByteBuffer	calloc(long nmemb, long size) Allocates memory for an array of nmemb elements of size bytes each and returns a pointer to the allocated memory.
static void	free(java.nio.ByteBuffer ptr) Frees the memory space pointed to by ptr, which must have been returned by a previous call to LibCStdlib.malloc(long), LibCStdlib.calloc(long, long), or LibCStdlib.realloc(java.nio.ByteBuffer, long).
static void	free(java.nio.DoubleBuffer ptr) Frees the memory space pointed to by ptr, which must have been returned by a previous call to LibCStdlib.malloc(long), LibCStdlib.calloc(long, long), or LibCStdlib.realloc(java.nio.ByteBuffer, long).
static void	free(java.nio.FloatBuffer ptr) Frees the memory space pointed to by ptr, which must have been returned by a previous call to LibCStdlib.malloc(long), LibCStdlib.calloc(long, long), or LibCStdlib.realloc(java.nio.ByteBuffer, long).
static void	free(java.nio.IntBuffer ptr) Frees the memory space pointed to by ptr, which must have been returned by a previous call to LibCStdlib.malloc(long), LibCStdlib.calloc(long, long), or LibCStdlib.realloc(java.nio.ByteBuffer, long).
static void	free(java.nio.LongBuffer ptr) Frees the memory space pointed to by ptr, which must have been returned by a previous call to LibCStdlib.malloc(long), LibCStdlib.calloc(long, long), or LibCStdlib.realloc(java.nio.ByteBuffer, long).
static void	free(PointerBuffer ptr) Frees the memory space pointed to by ptr, which must have been returned by a previous call to LibCStdlib.malloc(long), LibCStdlib.calloc(long, long), or LibCStdlib.realloc(java.nio.ByteBuffer, long).
static void	free(java.nio.ShortBuffer ptr) Frees the memory space pointed to by ptr, which must have been returned by a previous call to LibCStdlib.malloc(long), LibCStdlib.calloc(long, long), or LibCStdlib.realloc(java.nio.ByteBuffer, long).
static java.nio.ByteBuffer	malloc(long size) Allocates size bytes and returns a pointer to the allocated memory.
static java.nio.ByteBuffer	realloc(java.nio.ByteBuffer ptr, long size) Changes the size of the memory block pointed to by ptr to size bytes The contents will be unchanged in the range from the start of the region up to the minimum of the old and new sizes.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

malloc

public static java.nio.ByteBuffer malloc(long size)

Allocates size bytes and returns a pointer to the allocated memory. The memory is not initialized. If size is 0, then malloc() returns either NULL, or a unique pointer value that can later be successfully passed to LibCStdlib.free(java.nio.ByteBuffer).

Parameters:

size - the number of bytes to allocate

calloc

public static java.nio.ByteBuffer calloc(long nmemb,
                                         long size)

Allocates memory for an array of nmemb elements of size bytes each and returns a pointer to the allocated memory. The memory is set to zero. If nmemb or size is 0, then calloc() returns either NULL, or a unique pointer value that can later be successfully passed to LibCStdlib.free(java.nio.ByteBuffer).

Parameters:

nmemb - the number of elements to allocate

size - the number of bytes to allocate per element

realloc

public static java.nio.ByteBuffer realloc(java.nio.ByteBuffer ptr,
                                          long size)

Changes the size of the memory block pointed to by ptr to size bytes The contents will be unchanged in the range from the start of the region up to the minimum of the old and new sizes. If the new size is larger than the old size, the added memory will not be initialized. If ptr is NULL, then the call is equivalent to malloc(size), for all values of size; if size is equal to zero, and ptr is not NULL, then the call is equivalent to free(ptr). Unless ptr is NULL, it must have been returned by an earlier call to LibCStdlib.malloc(long), LibCStdlib.calloc(long, long) or LibCStdlib.realloc(java.nio.ByteBuffer, long). If the area pointed to was moved, a free(ptr) is done.

Parameters:

ptr - the memory block to reallocate

size - the new memory block size, in bytes

free

public static void free(java.nio.ByteBuffer ptr)

public static void free(java.nio.ShortBuffer ptr)

public static void free(java.nio.IntBuffer ptr)

public static void free(java.nio.LongBuffer ptr)

public static void free(java.nio.FloatBuffer ptr)

public static void free(java.nio.DoubleBuffer ptr)

public static void free(PointerBuffer ptr)

Frees the memory space pointed to by ptr, which must have been returned by a previous call to LibCStdlib.malloc(long), LibCStdlib.calloc(long, long), or LibCStdlib.realloc(java.nio.ByteBuffer, long). Otherwise, or if free(ptr) has already been called before, undefined behavior occurs. If ptr is NULL, no operation is performed.

Parameters:

ptr - the memory space to free

aligned_alloc

public static java.nio.ByteBuffer aligned_alloc(long alignment,
                                                long size)

Allocates size bytes of uninitialized storage whose alignment is specified by alignment. The size parameter must be an integral multiple of alignment. Memory allocated with aligned_alloc() must be freed with LibCStdlib.aligned_free(java.nio.ByteBuffer).

Parameters:

alignment - the alignment. Must be a power of two value.

size - the number of bytes to allocate. Must be a multiple of alignment.

aligned_free

public static void aligned_free(java.nio.ByteBuffer ptr)

public static void aligned_free(java.nio.ShortBuffer ptr)

public static void aligned_free(java.nio.IntBuffer ptr)

public static void aligned_free(java.nio.LongBuffer ptr)

public static void aligned_free(java.nio.FloatBuffer ptr)

public static void aligned_free(java.nio.DoubleBuffer ptr)

public static void aligned_free(PointerBuffer ptr)

Frees a block of memory that was allocated with LibCStdlib.aligned_alloc(long, long). If ptr is NULL, no operation is performed.

Parameters:

ptr - the aligned block of memory to free