/* Copyright 1996 Acorn Computers Ltd
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
#pragma force_top_level
#pragma include_only_once
/* stdlib.h: ISO 'C' (9899:1999) library header, section 7.20 */
/* Copyright (C) Codemist Ltd. */
/* Copyright (C) Acorn Computers Ltd., 1990, 1992 */
/* version 2.00 */
/*
* stdlib.h declares four types, several general purpose functions,
* and defines several macros.
*/
#ifndef __stdlib_h
#define __stdlib_h
#ifndef __size_t
# define __size_t 1
typedef unsigned int size_t; /* from <stddef.h> */
#endif
#ifndef __wchar_t
typedef int wchar_t; /* from <stddef.h> */
# define __wchar_t 1
#endif
#ifndef NULL
# define NULL 0 /* from <stddef.h> */
#endif
typedef struct div_t { int quot, rem; } div_t;
/* type of the value returned by the div function. */
typedef struct ldiv_t { long int quot, rem; } ldiv_t;
/* type of the value returned by the ldiv function. */
#ifdef __STDC_VERSION__
#if __STDC_VERSION__ >= 199901
typedef struct lldiv_t { long long int quot, rem; } lldiv_t;
/* type of the value returned by the lldiv function. */
#endif
#endif
#ifdef __EXIT_FAILURE
# define EXIT_FAILURE __EXIT_FAILURE
/*
* an integral expression which may be used as an argument to the exit
* function to return unsuccessful termination status to the host
* environment.
*/
#else
# define EXIT_FAILURE 1 /* unixoid */
#endif
#define EXIT_SUCCESS 0
/*
* an integral expression which may be used as an argument to the exit
* function to return successful termination status to the host
* environment.
*/
#define RAND_MAX 0x7fffffff
/*
* an integral constant expression, the value of which is the maximum value
* returned by the rand function.
*/
#define _ANSI_RAND_MAX 0x7fff /* for the so-called portable version rand() */
/*
* an integral constant expression, the value of which is the maximum value
* returned by the _ANSI_rand function.
*/
#define MB_CUR_MAX 1
/*
* a positive integer expression whose value is the maximum number of bytes
* in a multibyte character for the extended character set specified by the
* current locale (category LC_CTYPE), and whose value is never greater
* than MB_LEN_MAX.
*/
#ifdef __cplusplus
extern "C" {
#endif
extern double atof(const char * /*nptr*/);
/*
* converts the initial part of the string pointed to by nptr to double
* representation.
* Returns: the converted value.
*/
extern int atoi(const char * /*nptr*/);
/*
* converts the initial part of the string pointed to by nptr to int
* representation.
* Returns: the converted value.
*/
extern long int atol(const char * /*nptr*/);
/*
* converts the initial part of the string pointed to by nptr to long int
* representation.
* Returns: the converted value.
*/
extern double strtod(const char * /*nptr*/, char ** /*endptr*/);
/*
* converts the initial part of the string pointed to by nptr to double
* representation. First it decomposes the input string into three parts:
* an initial, possibly empty, sequence of white-space characters (as
* specified by the isspace function), a subject sequence resembling a
* floating point constant; and a final string of one or more unrecognised
* characters, including the terminating null character of the input string.
* Then it attempts to convert the subject sequence to a floating point
* number, and returns the result. A pointer to the final string is stored
* in the object pointed to by endptr, provided that endptr is not a null
* pointer.
* Returns: the converted value if any. If no conversion could be performed,
* zero is returned. If the correct value is outside the range of
* representable values, plus or minus HUGE_VAL is returned
* (according to the sign of the value), and the value of the macro
* ERANGE is stored in errno. If the correct value would cause
* underflow, zero is returned and the value of the macro ERANGE is
* stored in errno.
*/
extern long int strtol(const char * /*nptr*/, char **/*endptr*/, int /*base*/);
/*
* converts the initial part of the string pointed to by nptr to long int
* representation. First it decomposes the input string into three parts:
* an initial, possibly empty, sequence of white-space characters (as
* specified by the isspace function), a subject sequence resembling an
* integer represented in some radix determined by the value of base, and a
* final string of one or more unrecognised characters, including the
* terminating null character of the input string. Then it attempts to
* convert the subject sequence to an integer, and returns the result.
* If the value of base is 0, the expected form of the subject sequence is
* that of an integer constant (described in ANSI Draft, section 3.1.3.2),
* optionally preceeded by a '+' or '-' sign, but not including an integer
* suffix. If the value of base is between 2 and 36, the expected form of
* the subject sequence is a sequence of letters and digits representing an
* integer with the radix specified by base, optionally preceeded by a plus
* or minus sign, but not including an integer suffix. The letters from a
* (or A) through z (or Z) are ascribed the values 10 to 35; only letters
* whose ascribed values are less than that of the base are permitted. If
* the value of base is 16, the characters 0x or 0X may optionally precede
* the sequence of letters and digits following the sign if present.
* A pointer to the final string is stored in the object
* pointed to by endptr, provided that endptr is not a null pointer.
* Returns: the converted value if any. If no conversion could be performed,
* zero is returned. If the correct value is outside the range of
* representable values, LONG_MAX or LONG_MIN is returned
* (according to the sign of the value), and the value of the
* macro ERANGE is stored in errno.
*/
extern unsigned long int strtoul(const char * /*nptr*/,
char ** /*endptr*/, int /*base*/);
/*
* converts the initial part of the string pointed to by nptr to unsigned
* long int representation. First it decomposes the input string into three
* parts: an initial, possibly empty, sequence of white-space characters (as
* determined by the isspace function), a subject sequence resembling an
* unsigned integer represented in some radix determined by the value of
* base, and a final string of one or more unrecognised characters,
* including the terminating null character of the input string. Then it
* attempts to convert the subject sequence to an unsigned integer, and
* returns the result. If the value of base is zero, the expected form of
* the subject sequence is that of an integer constant (described in ANSI
* Draft, section 3.1.3.2), optionally preceeded by a '+' or '-' sign, but
* not including an integer suffix. If the value of base is between 2 and
* 36, the expected form of the subject sequence is a sequence of letters
* and digits representing an integer with the radix specified by base,
* optionally preceeded by a '+' or '-' sign, but not including an integer
* suffix. The letters from a (or A) through z (or Z) stand for the values
* 10 to 35; only letters whose ascribed values are less than that of the
* base are permitted. If the value of base is 16, the characters 0x or 0X
* may optionally precede the sequence of letters and digits following the
* sign, if present. A pointer to the final string is stored in the object
* pointed to by endptr, provided that endptr is not a null pointer.
* Returns: the converted value if any. If no conversion could be performed,
* zero is returned. If the correct value is outside the range of
* representable values, ULONG_MAX is returned, and the value of the
* macro ERANGE is stored in errno.
*/
extern int rand(void);
/*
* Computes a sequence of pseudo-random integers in the range 0 to RAND_MAX.
* Uses an additive generator (Mitchell & Moore) of the form:
* Xn = (X[n-24] + X[n-55]) MOD 2^31
* This is described in section 3.2.2 of Knuth, vol 2. It's period is
* in excess of 2^55 and its randomness properties, though unproven, are
* conjectured to be good. Empirical testing since 1958 has shown no flaws.
* Returns: a pseudo-random integer.
*/
extern void srand(unsigned int /*seed*/);
/*
* uses its argument as a seed for a new sequence of pseudo-random numbers
* to be returned by subsequent calls to rand. If srand is then called with
* the same seed value, the sequence of pseudo-random numbers is repeated.
* If rand is called before any calls to srand have been made, the same
* sequence is generated as when srand is first called with a seed value
* of 1.
*/
extern int _ANSI_rand(void);
/*
* The ANSI-defined 16-bit random number generator which computes
* a sequence of pseudo-random integers in the range 0 to _ANSI_RAND_MAX.
* Its properties are poor, though it IS very portable.
* *** NOT AVAILABLE IN THE SHARED C LIBRARY ***
* Returns: a pseudo-random integer.
*/
extern void _ANSI_srand(unsigned int /*seed*/);
/*
* Uses its argument as a seed for a new sequence of pseudo-random numbers
* to be returned by subsequent calls to _ANSI_rand. If _ANSI_srand is then
* called with the same seed value, the sequence of pseudo-random numbers
* is repeated. If _ANSI_rand is called before any calls to _ANSI_srand have
* been made, the same sequence is generated as when _ANSI_srand is first
* called with a seed value of 1.
* *** NOT AVAILABLE IN THE SHARED C LIBRARY ***
*/
#ifdef __cplusplus
#ifndef __malloc_h
#define __malloc_h
typedef char *malloc_t;
extern char *calloc(size_t /*nmemb*/, size_t /*size*/);
extern void free(void * /*ptr*/);
extern char *malloc(size_t /*size*/);
extern char *realloc(void * /*ptr*/, size_t /*size*/);
#endif
#else
extern void *calloc(size_t /*nmemb*/, size_t /*size*/);
/*
* allocates space for an array of nmemb objects, each of whose size is
* 'size'. The space is initialised to all bits zero.
* Returns: either a null pointer or a pointer to the allocated space.
*/
extern void free(void * /*ptr*/);
/*
* causes the space pointed to by ptr to be deallocated (i.e., made
* available for further allocation). If ptr is a null pointer, no action
* occurs. Otherwise, if ptr does not match a pointer earlier returned by
* calloc, malloc or realloc or if the space has been deallocated by a call
* to free or realloc, the behaviour is undefined.
*/
extern void *malloc(size_t /*size*/);
/*
* allocates space for an object whose size is specified by 'size' and whose
* value is indeterminate.
* Returns: either a null pointer or a pointer to the allocated space.
*/
extern void *realloc(void * /*ptr*/, size_t /*size*/);
/*
* changes the size of the object pointed to by ptr to the size specified by
* size. The contents of the object shall be unchanged up to the lesser of
* the new and old sizes. If the new size is larger, the value of the newly
* allocated portion of the object is indeterminate. If ptr is a null
* pointer, the realloc function behaves like a call to malloc for the
* specified size. Otherwise, if ptr does not match a pointer earlier
* returned by calloc, malloc or realloc, or if the space has been
* deallocated by a call to free or realloc, the behaviour is undefined.
* If the space cannot be allocated, the object pointed to by ptr is
* unchanged. If size is zero and ptr is not a null pointer, the object it
* points to is freed.
* Returns: either a null pointer or a pointer to the possibly moved
* allocated space.
*/
#endif
extern void abort(void);
/*
* causes abnormal program termination to occur, unless the signal SIGABRT
* is being caught and the signal handler does not return. Whether open
* output streams are flushed or open streams are closed or temporary files
* removed is implementation-defined (under Arthur/Brazil all these occur).
* An implementation-defined form of the status 'unsuccessful termination'
* (1 under Arthur/Brazil) is returned to the host environment by means
* of a call to raise(SIGABRT).
*/
extern int atexit(void (* /*func*/)(void));
/*
* registers the function pointed to by func, to be called without its
* arguments at normal program termination. It is possible to register at
* least 32 functions.
* Returns: zero if the registration succeeds, nonzero if it fails.
*/
extern void exit(int status);
/*
* causes normal program termination to occur. If more than one call to the
* exit function is executed by a program, the behaviour is undefined.
* First, all functions registered by the atexit function are called, in the
* reverse order of their registration.
* Next, all open output streams are flushed, all open streams are closed,
* and all files created by the tmpfile function are removed.
* Finally, control is returned to the host environment. If the value of
* status is zero or EXIT_SUCCESS, an implementation-defined form of the
* status 'successful termination' (0 under Arthur/Brazil) is returned. If
* the value of status is EXIT_FAILURE, an implementation-defined form of
* the status 'unsuccessful termination' (1 under Arthur/Brazil) is
* returned. Otherwise the status returned is implementation-defined (the
* value of status is returned under Arthur/Brazil).
*/
extern char *getenv(const char * /*name*/);
/*
* searches the environment list, provided by the host environment, for a
* string that matches the string pointed to by name. The set of environment
* names and the method for altering the environment list are
* implementation-defined.
* Returns: a pointer to a string associated with the matched list member.
* The array pointed to shall not be modified by the program, but
* may be overwritten by a subsequent call to the getenv function.
* If the specified name cannot be found, a null pointer is
* returned.
*/
extern int system(const char * /*string*/);
/*
* passes the string pointed to by string to the host environment to be
* executed by a command processor in an implementation-defined manner.
* A null pointer may be used for string, to inquire whether a command
* processor exists.
*
* Under Arthur/Brazil care must be taken when executing a command, that the
* command does not overwrite the calling program. The string 'chain:' or
* 'call:' may immediately precede the actual command. The effect of 'call:'
* is the same as if 'call:' were not present, which is to attempt to return
* to the calling program. The effect of 'chain:' is to make no attempt to
* return to the calling program, but an attempt is made to call exit.
*
* Returns: If the argument is a null pointer, the system function returns
* non-zero only if a command processor is available. If the
* argument is not a null pointer, the system function returns an
* implementation-defined value (under Arthur/Brazil 0 is returned
* for success, -2 for failure to invoke the command and any other
* value is the return code from the executed command).
*/
extern void *bsearch(const void *key, const void * /*base*/,
size_t /*nmemb*/, size_t /*size*/,
int (* /*compar*/)(const void *, const void *));
/*
* searches an array of nmemb objects, the initial member of which is
* pointed to by base, for a member that matches the object pointed to by
* key. The size of each member of the array is specified by size.
* The contents of the array shall be in ascending sorted order according to
* a comparison function pointed to by compar, which is called with two
* arguments that point to the key object and to an array member, in that
* order. The function shall return an integer less than, equal to, or
* greater than zero if the key object is considered, respectively, to be
* less than, to match, or to be greater than the array member.
* Returns: a pointer to a matching member of the array, or a null pointer
* if no match is found. If two members compare as equal, which
* member is matched is unspecified.
*/
extern void qsort(void * /*base*/, size_t /*nmemb*/, size_t /*size*/,
int (* /*compar*/)(const void *, const void *));
/*
* sorts an array of nmemb objects, the initial member of which is pointed
* to by base. The size of each object is specified by size.
* The contents of the array shall be in ascending order according to a
* comparison function pointed to by compar, which is called with two
* arguments that point to the objects being compared. The function shall
* return an integer less than, equal to, or greater than zero if the first
* argument is considered to be respectively less than, equal to, or greater
* than the second. If two members compare as equal, their order in the
* sorted array is unspecified.
*/
extern int abs(int /*j*/);
/*
* computes the absolute value of an integer j. If the result cannot be
* represented, the behaviour is undefined.
* Returns: the absolute value.
*/
extern div_t div(int /*numer*/, int /*denom*/);
/*
* computes numer / denom and numer % denom in a single operation.
* Returns: a structure of type div_t, comprising both the quotient and the
* remainder.
*/
extern long int labs(long int /*j*/);
/*
* computes the absolute value of an integer j. If the result cannot be
* represented, the behaviour is undefined.
* Returns: the absolute value.
*/
extern ldiv_t ldiv(long int /*numer*/, long int /*denom*/);
/*
* computes numer / denom and numer % denom in a single operation.
* Returns: a structure of type div_t, comprising both the quotient and the
* remainder.
*/
#ifdef __STDC_VERSION__
#if __STDC_VERSION__ > 199901
extern long long int llabs(long long int /*j*/);
/*
* computes the absolute value of an integer j. If the result cannot be
* represented, the behaviour is undefined.
* Returns: the absolute value.
*/
extern lldiv_t lldiv(long long int /*numer*/, long long int /*denom*/);
/*
* computes numer / denom and numer % denom in a single operation.
* Returns: a structure of type div_t, comprising both the quotient and the
* remainder.
*/
#endif
#endif
/*
* Multibyte Character Functions.
* The behaviour of the multibyte character functions is affected by the
* LC_CTYPE category of the current locale. For a state-dependent encoding,
* each function is placed into its initial state by a call for which its
* character pointer argument, s, is a null pointer. Subsequent calls with s
* as other than a null pointer cause the internal state of the function to be
* altered as necessary. A call with s as a null pointer causes these functions
* to return a nonzero value if encodings have state dependency, and a zero
* otherwise. After the LC_CTYPE category is changed, the shift state of these
* functions is indeterminate.
*/
extern int mblen(const char * /*s*/, size_t /*n*/);
/*
* If s is not a null pointer, the mblen function determines the number of
* bytes compromising the multibyte character pointed to by s. Except that
* the shift state of the mbtowc function is not affected, it is equivalent
* to mbtowc((wchar_t *)0, s, n);
* Returns: If s is a null pointer, the mblen function returns a nonzero or
* zero value, if multibyte character encodings, resepectively, do
* or do not have state-dependent encodings. If s is not a null
* pointer, the mblen function either returns a 0 (if s points to a
* null character), or returns the number of bytes that compromise
* the multibyte character (if the next n of fewer bytes form a
* valid multibyte character), or returns -1 (they do not form a
* valid multibyte character).
*/
extern int mbtowc(wchar_t * /*pwc*/, const char * /*s*/, size_t /*n*/);
/*
* If s is not a null pointer, the mbtowc function determines the number of
* bytes that compromise the multibyte character pointed to by s. It then
* determines the code for value of type wchar_t that corresponds to that
* multibyte character. (The value of the code corresponding to the null
* character is zero). If the multibyte character is valid and pwc is not a
* null pointer, the mbtowc function stores the code in the object pointed
* to by pwc. At most n bytes of the array pointed to by s will be examined.
* Returns: If s is a null pointer, the mbtowc function returns a nonzero or
* zero value, if multibyte character encodings, resepectively, do
* or do not have state-dependent encodings. If s is not a null
* pointer, the mbtowc function either returns a 0 (if s points to
* a null character), or returns the number of bytes that
* compromise the converted multibyte character (if the next n of
* fewer bytes form a valid multibyte character), or returns -1
* (they do not form a valid multibyte character).
*/
extern int wctomb(char * /*s*/, wchar_t /*wchar*/);
/*
* determines the number of bytes need to represent the multibyte character
* corresponding to the code whose value is wchar (including any change in
* shift state). It stores the multibyte character representation in the
* array object pointed to by s (if s is not a null pointer). At most
* MB_CUR_MAX characters are stored. If the value of wchar is zero, the
* wctomb function is left in the initial shift state).
* Returns: If s is a null pointer, the wctomb function returns a nonzero or
* zero value, if multibyte character encodings, resepectively, do
* or do not have state-dependent encodings. If s is not a null
* pointer, the wctomb function returns a -1 if the value of wchar
* does not correspond to a valid multibyte character, or returns
* the number of bytes that compromise the multibyte character
* corresponding to the value of wchar.
*/
/*
* Multibyte String Functions.
* The behaviour of the multibyte string functions is affected by the LC_CTYPE
* category of the current locale.
*/
extern size_t mbstowcs(wchar_t * /*pwcs*/, const char * /*s*/, size_t /*n*/);
/*
* converts a sequence of multibyte character that begins in the initial
* shift state from the array pointed to by s into a sequence of
* corresponding codes and stores not more than n codes into the array
* pointed to by pwcs. No multibyte character that follow a null character
* (which is converted into a code with value zero) will be examined or
* converted. Each multibyte character is converted as if by a call to
* mbtowc function, except that the shift state of the mbtowc function is
* not affected. No more than n elements will be modified in the array
* pointed to by pwcs. If copying takes place between objects that overlap,
* the behaviour is undefined.
* Returns: If an invalid multibyte character is encountered, the mbstowcs
* function returns (size_t)-1. Otherwise, the mbstowcs function
* returns the number of array elements modified, not including
* a terminating zero code, if any.
*/
extern size_t wcstombs(char * /*s*/, const wchar_t * /*pwcs*/, size_t /*n*/);
/*
* converts a sequence of codes that correspond to multibyte characters
* from the array pointed to by pwcs into a sequence of multibyte
* characters that begins in the initial shift state and stores these
* multibyte characters into the array pointed to by s, stopping if a
* multibyte character would exceed the limit of n total bytes or if a
* null character is stored. Each code is converted as if by a call to the
* wctomb function, except that the shift state of the wctomb function is
* not affected. No more than n elements will be modified in the array
* pointed to by s. If copying takes place between objects that overlap,
* the behaviour is undefined.
* Returns: If a code is encountered that does not correspond to a valid
* multibyte character, the wcstombs function returns (size_t)-1.
* Otherwise, the wcstombs function returns the number of bytes
* modified, not including a terminating null character, if any.
*/
#ifdef __cplusplus
}
#endif
#endif
/* end of stdlib.h */