Guardian Programming Reference Summary for C

Functions Summary (G-N)
Guardian Programming Reference Summary for C—522630-001
6-7
HEADROOM_ENSURE_
Allows you to check that the current stack has enough room for the needs of your
process. This procedure can help you, for example, when specifying parameters for the
PROCESS_LAUNCH_ procedure.
return value:
HEAPSORT
sorts an array of equal-sized elements in place.
Note. This procedure can be called only from a TNS/R native process. Its pTAL syntax is
declared only in the EXTDECS0 file.
#include <cextdecs(HEADROOM_ENSURE_)>
long HEADROOM_ENSURE_ ( long room ); /* i */
0D = Either the requested space already exists in the stack space or the stack space
was successfully enlarged to make enough room for the request.
5D = The request would have exceeded the maximum stack size.
6D = The stack pointer is invalid.
7D = The stack pointer does not address a main stack or a privileged stack.
36D = The system was unable to allocate memory.
43D = The system was unable to obtain swap space.
45D = The Kernel Managed Swap Facility (KMSF) was unable to obtain swap
space.
#include <cextdecs(HEAPSORT)>
short HEAPSORT ( short _near *array /* i,o */
,short num-elements /* i */
,short size-of-element /* i */
,short (*)()compare-function );/* i */