com.oracle.svm.core.windows.headers

Class LibC

java.lang.Object

com.oracle.svm.core.windows.headers.LibC

public class LibC
extends Object

Basic functions from the standard Visual Studio C Run-Time library

Field Summary

Fields

Modifier and Type	Field and Description
static int	EXIT_CODE_ABORT

Constructor Summary

Constructors

Constructor and Description
LibC()

Method Summary

Modifier and Type	Method and Description
static void	abort()
static void	bzero(org.graalvm.word.PointerBase s, org.graalvm.word.UnsignedWord n) The bzero() function writes n zeroed bytes to the string s.
static <T extends org.graalvm.word.PointerBase> T	calloc(org.graalvm.word.UnsignedWord nmemb, org.graalvm.word.UnsignedWord size) The calloc() function allocates memory for an array of nmemb elements of size bytes each and returns a pointer to the allocated memory.
static void	exit(int status)
static void	free(org.graalvm.word.PointerBase ptr) The free() function frees the memory space pointed to by ptr, which must have been returned by a previous call to malloc(), calloc() or realloc().
static <T extends org.graalvm.word.PointerBase> T	malloc(org.graalvm.word.UnsignedWord size) The malloc() function allocates size bytes and returns a pointer to the allocated memory.
static <T extends org.graalvm.word.PointerBase> T	memcpy(T dest, org.graalvm.word.PointerBase src, org.graalvm.word.UnsignedWord n) The memcpy() function copies n bytes from memory area src to memory area dest.
static <T extends org.graalvm.word.PointerBase> T	memmove(T dest, org.graalvm.word.PointerBase src, org.graalvm.word.UnsignedWord n) The memmove() function copies n bytes from memory area src to memory area dest.
static <T extends org.graalvm.word.PointerBase> T	memset(T s, org.graalvm.word.SignedWord c, org.graalvm.word.UnsignedWord n) The memset() function fills the first n bytes of the memory area pointed to by s with the constant byte c.
static <T extends org.graalvm.word.PointerBase> T	realloc(org.graalvm.word.PointerBase ptr, org.graalvm.word.UnsignedWord size) The realloc() function changes the size of the memory block pointed to by ptr to size bytes.
static org.graalvm.nativeimage.c.type.CCharPointer	strchr(org.graalvm.nativeimage.c.type.CCharPointer s, int c) Returns a pointer to the first occurrence of the character c in the string s.
static int	strcmp(org.graalvm.word.PointerBase s1, org.graalvm.word.PointerBase s2) Lexicographically compare null-terminated strings s1 and s2.
static org.graalvm.nativeimage.c.type.CCharPointer	strcpy(org.graalvm.nativeimage.c.type.CCharPointer dst, org.graalvm.nativeimage.c.type.CCharPointer src) Copy a zero-terminated string from source to destination.
static org.graalvm.nativeimage.c.type.CCharPointer	strdup(org.graalvm.nativeimage.c.type.CCharPointer src) Copy a zero-terminated string from source to a newly allocated destination.
static org.graalvm.word.UnsignedWord	strlcpy(org.graalvm.nativeimage.c.type.CCharPointer dst, org.graalvm.nativeimage.c.type.CCharPointer src, org.graalvm.word.UnsignedWord len)
static org.graalvm.word.UnsignedWord	strlen(org.graalvm.nativeimage.c.type.CCharPointer s) Calculate the length of a string.
static org.graalvm.nativeimage.c.type.CCharPointer	strncpy(org.graalvm.nativeimage.c.type.CCharPointer dst, org.graalvm.nativeimage.c.type.CCharPointer src, org.graalvm.word.UnsignedWord len) Copy a zero-terminated string from source to a zero-terminated destination of at most len characters.
static org.graalvm.nativeimage.c.type.CCharPointer	strtok_r(org.graalvm.nativeimage.c.type.CCharPointer str, org.graalvm.nativeimage.c.type.CCharPointer delim, org.graalvm.nativeimage.c.type.CCharPointerPointer saveptr)
static long	strtol(org.graalvm.nativeimage.c.type.CCharPointer nptr, org.graalvm.nativeimage.c.type.CCharPointerPointer endptr, int base) Convert the of the string to an integer, according to the specified radix.

Methods inherited from class java.lang.Object

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

Field Detail

EXIT_CODE_ABORT

public static final int EXIT_CODE_ABORT

See Also:

Constant Field Values

Constructor Detail

LibC

public LibC()

Method Detail

memcpy

public static <T extends org.graalvm.word.PointerBase> T memcpy(T dest,
                                                                org.graalvm.word.PointerBase src,
                                                                org.graalvm.word.UnsignedWord n)

The memcpy() function copies n bytes from memory area src to memory area dest. The memory areas must not overlap. Use memmove(3) if the memory areas do overlap. We re-wire `memcpy()` to `memmove()` in order to avoid backwards compatibility issues with systems that run older versions of `glibc`. Without this change image construction would use `glibc` from the machine that constructs the image. Then, the image would not link with older `glibc` versions.

Returns:

The memcpy() function returns a pointer to dest.

memmove

public static <T extends org.graalvm.word.PointerBase> T memmove(T dest,
                                                                 org.graalvm.word.PointerBase src,
                                                                 org.graalvm.word.UnsignedWord n)

The memmove() function copies n bytes from memory area src to memory area dest. The memory areas may overlap: copying takes place as though the bytes in src are first copied into a temporary array that does not overlap src or dest, and the bytes are then copied from the temporary array to dest.

Returns:

The memmove() function returns a pointer to dest.

memset

public static <T extends org.graalvm.word.PointerBase> T memset(T s,
                                                                org.graalvm.word.SignedWord c,
                                                                org.graalvm.word.UnsignedWord n)

The memset() function fills the first n bytes of the memory area pointed to by s with the constant byte c.

Returns:

The memset() function returns a pointer to the memory area s.

bzero

public static void bzero(org.graalvm.word.PointerBase s,
                         org.graalvm.word.UnsignedWord n)

The bzero() function writes n zeroed bytes to the string s. If n is zero, bzero() does nothing.

malloc

public static <T extends org.graalvm.word.PointerBase> T malloc(org.graalvm.word.UnsignedWord size)

The malloc() function 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 free().

Returns:

The malloc() and calloc() functions return a pointer to the allocated memory that is suitably aligned for any kind of variable. On error, these functions return NULL. NULL may also be returned by a successful call to malloc() with a size of zero, or by a successful call to calloc() with nmemb or size equal to zero.

calloc

public static <T extends org.graalvm.word.PointerBase> T calloc(org.graalvm.word.UnsignedWord nmemb,
                                                                org.graalvm.word.UnsignedWord size)

The calloc() function 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 free().

Returns:

The malloc() and calloc() functions return a pointer to the allocated memory that is suitably aligned for any kind of variable. On error, these functions return NULL. NULL may also be returned by a successful call to malloc() with a size of zero, or by a successful call to calloc() with nmemb or size equal to zero.

realloc

public static <T extends org.graalvm.word.PointerBase> T realloc(org.graalvm.word.PointerBase ptr,
                                                                 org.graalvm.word.UnsignedWord size)

The realloc() function 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 malloc(), calloc() or realloc(). If the area pointed to was moved, a free(ptr) is done.

Returns:

The realloc() function returns a pointer to the newly allocated memory, which is suitably aligned for any kind of variable and may be different from ptr, or NULL if the request fails. If size was equal to 0, either NULL or a pointer suitable to be passed to free() is returned. If realloc() fails the original block is left untouched; it is not freed or moved.

free

public static void free(org.graalvm.word.PointerBase ptr)

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

exit

public static void exit(int status)

abort

public static void abort()

strcmp

public static int strcmp(org.graalvm.word.PointerBase s1,
                         org.graalvm.word.PointerBase s2)

Lexicographically compare null-terminated strings s1 and s2.

strcpy

public static org.graalvm.nativeimage.c.type.CCharPointer strcpy(org.graalvm.nativeimage.c.type.CCharPointer dst,
                                                                 org.graalvm.nativeimage.c.type.CCharPointer src)

Copy a zero-terminated string from source to destination.

strncpy

public static org.graalvm.nativeimage.c.type.CCharPointer strncpy(org.graalvm.nativeimage.c.type.CCharPointer dst,
                                                                  org.graalvm.nativeimage.c.type.CCharPointer src,
                                                                  org.graalvm.word.UnsignedWord len)

Copy a zero-terminated string from source to a zero-terminated destination of at most len characters.

strlcpy

public static org.graalvm.word.UnsignedWord strlcpy(org.graalvm.nativeimage.c.type.CCharPointer dst,
                                                    org.graalvm.nativeimage.c.type.CCharPointer src,
                                                    org.graalvm.word.UnsignedWord len)

strdup

public static org.graalvm.nativeimage.c.type.CCharPointer strdup(org.graalvm.nativeimage.c.type.CCharPointer src)

Copy a zero-terminated string from source to a newly allocated destination.

strchr

public static org.graalvm.nativeimage.c.type.CCharPointer strchr(org.graalvm.nativeimage.c.type.CCharPointer s,
                                                                 int c)

Returns a pointer to the first occurrence of the character c in the string s.

strlen

public static org.graalvm.word.UnsignedWord strlen(org.graalvm.nativeimage.c.type.CCharPointer s)

Calculate the length of a string.

strtok_r

public static org.graalvm.nativeimage.c.type.CCharPointer strtok_r(org.graalvm.nativeimage.c.type.CCharPointer str,
                                                                   org.graalvm.nativeimage.c.type.CCharPointer delim,
                                                                   org.graalvm.nativeimage.c.type.CCharPointerPointer saveptr)

strtol

public static long strtol(org.graalvm.nativeimage.c.type.CCharPointer nptr,
                          org.graalvm.nativeimage.c.type.CCharPointerPointer endptr,
                          int base)

Convert the of the string to an integer, according to the specified radix.