TutCalloc

Name

TutCalloc — allocate and clear memory

Synopsis

T_PTR TutCalloc(size) 
T_UINT4 size; 

Arguments

size — number of bytes to allocate

Return Values

Pointer to the allocated memory block if successful; NULL otherwise.

Diagnostics

None

Description

TutCalloc allocates and zeroes out a block of memory of the requested size. Using this function ensures the portability of the user-written applications to all platforms that are currently supported by SmartSockets.

TutCalloc allows size to be 0; this is useful for allocating a non-null placeholder that is resized later with TutRealloc.

All SmartSockets memory management uses the functions TutCalloc, TutFree, TutMalloc, and TutRealloc. You can set debugger breakpoints in these functions to trace SmartSockets memory usage.

Caution

TutCalloc, TutFree, TutMalloc, and TutRealloc are not compatible with other memory management functions. Memory allocated by SmartSockets (including memory allocated by TutCalloc, TutMalloc, or TutRealloc) must be reallocated with TutRealloc and freed with TutFree. Attempting to mix memory management functions will result in unpredictable and potentially unstable behavior.

See Also

TutFree, TutMalloc, TutRealloc

Examples

This example allocates and clears a string 30 characters long:

T_STR strptr; 
 
/* the string has to be 30 characters long, so one space has to be */ 
/* reserved for the terminating NULL */ 
strptr = (T_STR)TutCalloc(31);