//---
//
//	standard library module: stdlib
//
//	Provides standard functionalities such as dynamic allocation,
//	string/numeric conversion, and abort calls.
//
//---

#ifndef	_STDLIB_H
#define	_STDLIB_H	1

#include <stddef.h>

// Common exit codes.
#define	EXIT_SUCCESS	1
#define	EXIT_FAILURE	0



//---
//	Program exit functions.
//---

/*
	abort()
	Aborts the program execution without calling the exit handlers.
*/
void abort(void);

/*
	exit()
	Stops the program execution with the given status code, after calling
	the exit handlers.
*/
void exit(int status);



//---
//	Dynamic storage allocation.
//---

/*
	malloc()
	Allocates 'size' bytes and returns a pointer to a free memory area.
	Returns NULL on error.
*/
void *malloc(size_t size);

/*
	calloc()
	Allocates 'n' elements of size 'size' and wipes the memory area.
	Returns NULL on error.
*/
void *calloc(size_t n, size_t size);

/*
	free()
	Frees a memory block allocated with malloc().
*/
void free(void *ptr);



#endif	// _STDLIB_H