Guardian Programming Reference Summary for C

Functions Summary (G-N)
Guardian Programming Reference Summary for C—522630-001
6-8
HEAPSORTX_
Sorts an array of equal-sized elements in place.
return value:
HIST_FORMAT_
Produces an ASCII text representation of the process state whose context is established
by a previous call to the HIST_INIT_ procedure or HIST_GETPRIOR_ procedure. See
the HIST_INIT_ procedure for an overview of how HIST_INIT_, HIST_FORMAT_,
and HIST_GETPRIOR_ can be used together to perform stack tracing.
return value:
#include <cextdecs(HEAPSORTX_)>
short HEAPSORTX_ ( short *array /* i,o */
,long num-elements /* i */
,short size-of-element /* i */
,short (*)()compare-function );/* i */
0 = Array has been successfully sorted.
29 = Required parameter is missing.
590 = Invalid parameter supplied.
632 = Insufficient stack space for temporary variable.
#include <histry.h>
short HIST_FORMAT_ ( NSK_histWorkspace *workspace /* i,o */
,char *text /* o */
,const uint16 limit ); /* i */
-2 = HIST_BAD_WIDTH
The value of the limit parameter is less than the minimum width for output
defined by the Hist_MinWidth literal in the HHISTRY header file.
-9 = HIST_BAD_WORKSPACE
The workspace structure has an invalid version identifier. This error can
occur if HIST_FORMAT_ is called without first calling the HIST_INIT_
procedure or if the workspace structure has become corrupted.
-10 = HIST_BAD_FORMAT_CALL
Nothing to format. This error can occur if you call HIST_FORMAT_ again
after a previous call returned zero, indicating no more text for the current
context.