Digital

NAME

XieCalloc − This routine allocates a block of zeroed memory. 

C Format

pointer = XieCalloc(number,size)

C Argument Information

void      ∗pointer;
unsigned     number;
unsigned     size;

RETURN VALUES

The routine returns the address of the allocated memory block in the pointer argument. If the routine fails, the returned value is null. After using the memory, you should free the memory using the XieCfree or XieFree routine. 

PARAMETERS

numberThe number argument specifies the number of multiples of memory you want to allocate. 

sizeThe size argument specifies the number of bytes contained in each memory multiple. 

DESCRIPTION

This routine allocates a block of zeroed memory.  Using this routine, you can allocate blocks of zeroed memory for any use on the client side. The amount of memory allocated is equal to the number multiples multiplied by the number of bytes per multiple. 

XIE Events and Error Messages

Protocol Messages: None

XIE event returned: None

XieLib errors: Returns a null if the routine cannot allocate the memory

XieServer errors: None