Emerson PMT1, PME1 user manual MemMng, Type Value Legal Characters

Monitor: Standard Monitor Functions

Table 8-7:IsLegal Function Types

Type:	Value:	Legal Characters:
DECIMAL	0x8	0	- 9
HEX	0x4	0	- 9, A - F, a - f
UPPER	0x2	A - Z
LOWER	0x1	a - z
ALPHA	0x3	A - Z, a - z

If the character string contains legal characters, this function returns TRUE; otherwise, it returns FALSE. The string equivalent of the character functions isalpha(), isupper(), islower(), and isdigit() can be constructed from this function, which deals with the entire string instead of a single character.

MemMng

void *Malloc(NumBytes) unsigned long NumBytes;

void *Calloc(NumElements, Size) unsigned long NumElements, Size;

Free(MemLoc)

unsigned long *MemLoc;

CFree(Block)

unsigned long *Block;

void *ReAlloc(Block, NumBytes) char *Block;

unsigned long NumBytes;

MemReset()

MemAdd(MemAddr, MemSize) unsigned long MemAddr, MemBSize;

MemStats()

Description: The memory management functions allocate and free memory from a memory pool. The monitor initializes the memory pool to use all on-card memory after the monitor’s bss sec- tion. If any of the autoboot features are used, the memory pool is not initialized and the application program is required to set up the memory pool for these functions.

The functions Malloc, Calloc and ReAlloc allocate memory from the memory pool. Each of these functions returns a pointer to the memory requested if the request can be satisfied and NULL if there is not enough memory to satisfy the request. The function Malloc accepts one argument, NumBytes, indicating the number of bytes requested. The function Calloc accepts two arguments, NumElements and Size, indicating a request for a specified number of elements of the specified size. The function ReAlloc reallocates a memory block by either

10002367-02 PmT1 and PmE1 User’s Manual

8-39