stdlib.h File Reference

#include <types.h>

Go to the source code of this file.

Functions
void	exit (int status) OLDCALL
int	abs (int i)
long	labs (long num) OLDCALL
int	atoi (const char *s)
long	atol (const char *s)
char *	itoa (int n, char *s, unsigned char radix) OLDCALL
char *	uitoa (unsigned int n, char *s, unsigned char radix) OLDCALL
char *	ltoa (long n, char *s, unsigned char radix) OLDCALL
char *	ultoa (unsigned long n, char *s, unsigned char radix) OLDCALL
void *	calloc (size_t nmemb, size_t size)
void *	malloc (size_t size)
void *	realloc (void *ptr, size_t size)
void	free (void *ptr)
void *	bsearch (const void *key, const void *base, size_t nmemb, size_t size, int(*compar)(const void *, const void *) REENTRANT)
void	qsort (void *base, size_t nmemb, size_t size, int(*compar)(const void *, const void *) REENTRANT)

Function Documentation

exit()

void exit

(

int

status

)

file stdlib.h 'Standard library' functions, for whatever that means. Causes normal program termination and the value of status is returned to the parent. All open streams are flushed and closed.

abs()

int abs

(

int

i

)

Returns the absolute value of int i

Parameters

i	Int to obtain absolute value of

If i is negative, returns -i; else returns i.

labs()

long labs

(

long

num

)

Returns the absolute value of long int num

Parameters

num	Long integer to obtain absolute value of

atoi()

int atoi

(

const char *

s

)

Converts an ASCII string to an int

Parameters

s	String to convert to an int

The string may be of the format

[\s]*[+-][\d]+[\D]*

i.e. any number of spaces, an optional + or -, then an arbitrary number of digits.

The result is undefined if the number doesnt fit in an int.

Returns: Int value of string

atol()

long atol

(

const char *

s

)

Converts an ASCII string to a long.

Parameters

s	String to convert to an long int

See also

atoi()

Returns: Long int value of string

itoa()

char* itoa	(	int	n,
		char *	s,
		unsigned char	radix
	)

Converts an int into a base 10 ASCII string.

Parameters

n	Int to convert to a string
s	String to store the converted number
radix	Numerical base for converted number, ex: 10 is decimal base (parameter is required but not utilized on Game Boy and Analogue Pocket)

Can be used with set_bkg_based_tiles() for printing if the digit character tiles are not ascii-mapped.

Returns: Pointer to converted string

uitoa()

char* uitoa	(	unsigned int	n,
		char *	s,
		unsigned char	radix
	)

Converts an unsigned int into a base 10 ASCII string.

Parameters

n	Unsigned Int to convert to a string
s	String to store the converted number
radix	Numerical base for converted number, ex: 10 is decimal base (parameter is required but not utilized on Game Boy and Analogue Pocket)

Can be used with set_bkg_based_tiles() for printing if the digit character tiles are not ascii-mapped.

Returns: Pointer to converted string

ltoa()

char* ltoa	(	long	n,
		char *	s,
		unsigned char	radix
	)

Converts a long into a base 10 ASCII string.

Parameters

n	Long int to convert to a string
s	String to store the converted number
radix	Numerical base for converted number, ex: 10 is decimal base (parameter is required but not utilized on Game Boy and Analogue Pocket)

Can be used with set_bkg_based_tiles() for printing if the digit character tiles are not ascii-mapped.

Returns: Pointer to converted string

ultoa()

char* ultoa	(	unsigned long	n,
		char *	s,
		unsigned char	radix
	)

Converts an unsigned long into a base 10 ASCII string.

Parameters

n	Unsigned Long Int to convert to a string
s	String to store the converted number
radix	Numerical base for converted number, ex: 10 is decimal base (parameter is required but not utilized on Game Boy and Analogue Pocket)

Can be used with set_bkg_based_tiles() for printing if the digit character tiles are not ascii-mapped.

Returns: Pointer to converted string

calloc()

void* calloc	(	size_t	nmemb,
		size_t	size
	)

Memory allocation functions

malloc()

void* malloc

(

size_t

size

)

realloc()

void* realloc	(	void *	ptr,
		size_t	size
	)

free()

void free

(

void *

ptr

)

bsearch()

void* bsearch	(	const void *	key,
		const void *	base,
		size_t	nmemb,
		size_t	size,
		int(*)(const void *, const void *) REENTRANT	compar
	)

search a sorted array of nmemb items

Parameters

key	Pointer to object that is the key for the search
base	Pointer to first object in the array to search
nmemb	Number of elements in the array
size	Size in bytes of each element in the array
compar	Function used to compare two elements of the array

Returns: Pointer to array entry that matches the search key. If key is not found, NULL is returned.

qsort()

void qsort	(	void *	base,
		size_t	nmemb,
		size_t	size,
		int(*)(const void *, const void *) REENTRANT	compar
	)

Sort an array of nmemb items

Parameters

base	Pointer to first object in the array to sort
nmemb	Number of elements in the array
size	Size in bytes of each element in the array
compar	Function used to compare and sort two elements of the array