pub unsafe extern "C" fn k_heap_calloc(
h: *mut k_heap,
num: usize,
size: usize,
timeout: k_timeout_t,
) -> *mut c_void
Expand description
@brief Allocate and initialize memory for an array of objects from a k_heap
Allocates memory for an array of num objects of size and initializes all bytes in the allocated storage to zero. If no memory is available immediately, the call will block for the specified timeout (constructed via the standard timeout API, or K_NO_WAIT or K_FOREVER) waiting for memory to be freed. If the allocation cannot be performed by the expiration of the timeout, NULL will be returned. Allocated memory is aligned on a multiple of pointer sizes.
@note @a timeout must be set to K_NO_WAIT if called from ISR. @note When CONFIG_MULTITHREADING=n any @a timeout is treated as K_NO_WAIT.
@funcprops \isr_ok
@param h Heap from which to allocate @param num Number of objects to allocate @param size Desired size of each object to allocate @param timeout How long to wait, or K_NO_WAIT @return A pointer to valid heap memory, or NULL