Digital

NAME

XieRealloc − This routine reallocates (changes the size of) a block of memory. 

C Format

new_pointer = XieRealloc(ptr, size)

C Argument Information

void      ∗new_pointer;
char      ∗ptr;
unsigned     size;

RETURN VALUES

The routine returns the address of the reallocated block of memory in the new_pointer argument. If the routine fails, the routine returns a null. If you increase the size of the reallocated block of memory, the routine zeros the contents of the additional memory. 

If the address returned in the new_pointer argument is different than the address you specified for the ptr argument, the routine moved the original contents of the memory to the new address and deallocated the original block of memory. 

You should free the memory using either the XieCfree or the XieFree routine. 

PARAMETERS

ptrThe ptr argument specifies the address of the block of memory you want to reallocate. 

sizeThe size argument specifies the size in bytes to which you want to change the reallocated memory. 

DESCRIPTION

This routine reallocates (changes the size of) a block of memory. 

XIE Events and Error Messages

Protocol Messages: None

XIE event returned: None

XieLib errors: None

XieServer errors: None