_aligned_recalloc
更改使用 _aligned_malloc
或 _aligned_offset_malloc
分配的内存块的大小,并将内存初始化为 0。
语法
void * _aligned_recalloc(
void *memblock,
size_t num,
size_t size,
size_t alignment
);
参数
memblock
当前的内存块指针。
number
元素数量。
size
每个元素的大小(以字节为单位)。
alignment
对齐值,必须是 2 的整数次幂。
返回值
_aligned_recalloc
将返回指向重新分配的(并且可能已移动的)内存块的 void 指针。 如果大小为零且缓冲区自变量不为 NULL
,或内存不足以将块展开到给定的大小,则返回值为 NULL
。 在第一种情况下,会释放原始块。 在第二种情况下,将不会更改原始块。 返回值将指向适当对齐任何类型的对象的存储的存储空间。 若要获取指向类型而非 void 的指针,请在返回值上使用类型转换。
重新分配内存并更改块对齐是错误的。
注解
_aligned_recalloc
基于 malloc
。 有关使用 _aligned_offset_malloc
的详细信息,请参见malloc
。
如果内存分配失败或请求的大小大于 errno
,则此函数会将 ENOMEM
设置为 _HEAP_MAXREQ
。 有关 errno
的详细信息,请参阅 errno
、_doserrno
、_sys_errlist
和 _sys_nerr
。 此外,_aligned_recalloc
将验证其参数。 如果 alignment
不是 2 的幂,则此函数调用的参数句柄无效,如参数验证中所述。 如果允许执行继续,则此函数将返回 NULL
并将 errno
设置为 EINVAL
。
默认情况下,此函数的全局状态范围限定为应用程序。 若要更改此行为,请参阅 CRT 中的全局状态。
要求
例程 | 必需的标头 |
---|---|
_aligned_recalloc |
<malloc.h> |