NAME

XtCalloc − allocate memory for an array and initialize its bytes to zero. 

Synopsis

char *XtCalloc(num, size);

    Cardinal num;
    Cardinal size;

Inputs

numSpecifies the number of array elements to allocate. 

sizeSpecifies the size of an array element in bytes. 

Returns

A pointer to allocated memory. 

Description

XtCalloc() allocates memory for an array of num elements each of size bytes and initializes each allocated byte to zero.  If there is insufficient memory, XtCalloc() terminates by calling XtErrorMsg(). 

Usage

Note that in most cases, you will have to cast the return value of XtCalloc() to the type appropriate for the array elements you are allocating.  XtNew() and XtNewString() provide slightly higher-level approaches to memory allocation.  The function XtCalloc() is implemented by the Toolkit independently of the particular environment, so programs ported to a system not supporting calloc will still work. 

See Also

XtErrorMsg(1), XtFree(1), XtMalloc(1), XtNew(1), XtNewString(1), XtRealloc(1). 

Copyright O’Reilly & Assoc.  —  X Toolkit Intrinsics Reference Manual © O’Reilly & Associates