bcalloc_type

(C++-friendly checked memory allocation)

SYNOPSIS

#include <tap/basic.h>

type *bcalloc_type(size_t n, type);

bcalloc_type() is a wrapper around bcalloc() that takes a type instead of a size as its second argument. It converts that type to a size using sizeof and calls bcalloc(), casting the return value to a pointer to type. This is friendlier to C++ code.

As with bcalloc(), this is intended for use inside TAP test cases where the test case should be aborted if memory allocation fails. It will call sysbail() on failure rather than returning NULL.

RETURN VALUE

bcalloc_type() returns a pointer to the newly allocated memory, cast to a pointer to type. It will never return NULL on failure; if memory allocation fails, it will abort the program.

CAVEATS

bcalloc_type() does not guard against allocating 0 bytes, only calls the underlying C library functions, and may return NULL in that case on some platforms.

AUTHOR

Russ Allbery <eagle@eyrie.org>

COPYRIGHT AND LICENSE

Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. This file is offered as-is, without any warranty.

SPDX-License-Identifier: FSFAP