genericopenlibs/cstdlib/LINC/STDLIB_R.H
author andy simpson <andrews@symbian.org>
Fri, 17 Sep 2010 17:50:04 +0100
branchRCL_3
changeset 61 b670675990af
parent 0 e4d67989cc36
permissions -rw-r--r--
Merge Bug 2603 and Bug 3123 plus move exports to rom/bld.inf

/*
* Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description:
* Extension of <stdlib.h> with reentrant functions.
* 
*
*/



/**
 @file
 @publishedAll
 @released
*/


#ifndef _STDLIB_R_H_
#define _STDLIB_R_H_

#ifdef __cplusplus
extern "C" {
#endif

#include <stdlib.h>
#include <sys/reent.h>

/**
EPOC32 malloc uses the thread heap, so it is already thread-safe
and no _malloc_r variants are needed.
*/
#define _malloc_r(x,n)		malloc(n)
#define _calloc_r(x,n,m)	calloc(n,m)
#define _realloc_r(x,p,n)	realloc(p,n)
#define _free_r(x,p)		free(p)

IMPORT_C char*	_dtoa_r		(struct _reent *, double, int, int, int *, int*, char**);
IMPORT_C void	_mstats_r	(struct _reent *, char *);
IMPORT_C int	_system_r	(struct _reent *, const char *);
IMPORT_C int	_wsystem_r	(struct _reent *, const wchar_t *);
IMPORT_C int	_rand_r		(struct _reent *);
IMPORT_C void	_srand_r	(struct _reent *, unsigned);
IMPORT_C int	_setenv_r	(struct _reent *, const char *, const char *, int);
IMPORT_C void	_unsetenv_r	(struct _reent *, const char *);
IMPORT_C char*	_getenv_r	(struct _reent *, const char *);
IMPORT_C int	_wsetenv_r	(struct _reent *, const wchar_t *, const wchar_t *, int);
IMPORT_C void	_wunsetenv_r	(struct _reent *, const wchar_t *);
IMPORT_C wchar_t*	_wgetenv_r	(struct _reent *, const wchar_t *);
IMPORT_C unsigned long _strtoul_r(struct _reent *,const char *, char **, int);

/**
It's possible to override exit() by supplying abort(), exit() and _exit()
The generic exit() and abort() routines look like

void exit(int code) _ATTRIBUTE((noreturn))
{
	_atexit_processing_r(_REENT);
 	_exit(code);
}
void abort(void) _ATTRIBUTE((noreturn))
{
	_exit(1);
}

which then allows your _exit() to capture all exits from ESTLIB, 
except for __assert() which calls abort().
*/
IMPORT_C void _atexit_processing_r (struct _reent *);

#ifdef __cplusplus
}
#endif
#endif /* _STDLIB_R_H_ */