Memory, Tfree, Tmalloc – Argox PA-20 Programming Guide User Manual
Page 102: Totalheapsize, Usedheapsize
PT-20 Programming Guide
100
Purpose： Use the Tfree to release an allocated storage block to the pool of free
memory.
Syntax： void Tfree(void *mem_address);
Example call： Tfree(buffer);
Includes：
#include “SDK.h”
Description： The Tfree function returns to the pool of free memory a blockof memory
that was allocated earlier by Tmalloc. The address of the block is specified
by the argument mem_address, which is a pointer to the starting byte of the
block. A NULL pointer argument is ignored by Tfree.
Returns： None
Purpose： Use Tmalloc to allocate memory for an array of a given number of bytes,
not exceeding 256KB.
Syntax： void* Tmalloc(U32 num_bytes);
Example call： buffer = (char *)Tmalloc(100*sizeof(char));
Includes：
#include “SDK.h”
Description： The Tmalloc function allocates the number of bytes requested in the
argument num_bytes by calling internal Turbo C heap management
routines. The Tmalloc function will work properly for all memory models.
Returns： The Tmalloc function returns a pointer that is the starting address of the
memory allocated. The allocated memory is properly aligned (the address
of the first byte meets the requirements for storing any type of C variable). If
the memory allocation is unsuccessful because of insufficient space or bad
values of the arguments, a NULL is returned.
Comments： Note that when using Tmolloc to allocate storage for a specific data type,
you should cast the returned void pointer to that type.
Purpose： Checking the total heap size.
Syntax： int TotalHeapSize(void);
Example call： totalsize = TotalHeapSize();
Includes：
#include “SDK.h ”
Description： The TotalHeapSize function can get the total heap size.
Returns： The total heap size in units of Kbytes.