NAME¶

SDL_calloc - Allocate a zero-initialized array.

SYNOPSIS¶

#include <SDL3/SDL_stdinc.h>

void * SDL_calloc(size_t nmemb, size_t size);

DESCRIPTION¶

The memory returned by this function must be freed with SDL_free().

If either of nmemb or size is 0, they will both be set to 1.

If the allocation is successful, the returned pointer is guaranteed to be aligned to either the fundamental alignment (alignof(max_align_t) in C11 and later) or 2 sizeof(void )" , whichever is smaller.

FUNCTION PARAMETERS¶

nmemb

the number of elements in the array.

size

the size of each element of the array.

RETURN VALUE¶

Returns a pointer to the allocated array, or NULL if allocation failed.

THREAD SAFETY¶

It is safe to call this function from any thread.

AVAILABILITY¶

This function is available since SDL 3.2.0.

SEE ALSO¶

SDL_free(3), SDL_malloc(3), SDL_realloc(3)