_realloc_dbg
重新指定的块在堆中的内存通过移动和/或调整块 (请只调试版本)。
void *_realloc_dbg(
void *userData,
size_t newSize,
int blockType,
const char *filename,
int linenumber
);
参数
userData
对以前指定的指针内存块。newSize
请求的范围重新分配块 (字节)。blockType
请求的类型重新分配块: _CLIENT_BLOCK 或 _NORMAL_BLOCK。filename
对请求 realloc 操作或空源文件的名称的指针。linenumber
在 realloc 操作是请求或空的源文件中的行号。
filename 和 linenumber 参数才可用,当 _realloc_dbg 显式调用或 _CRTDBG_MAP_ALLOC 预处理器来定义。
返回值
在成功完成,此函数返回指向重新分配的部分内存块的用户,调用新的处理程序函数或返回 NULL。 有关返回行为的完整说明,请参见下面的 " 备注 " 节。 有关如何安装的更多信息使用新的处理程序函数,请参见 realloc 功能。
备注
_realloc_dbg 是 realloc 函数的 " debug " 版本。 当 _DEBUG 未定义时,每个调用 _realloc_dbg 减少到 realloc的调用。 realloc 和 _realloc_dbg 在基堆分配内存,但是, _realloc_dbg 满足一些调试功能:在测试块的两侧用户部分的缓冲区对于泄漏、跟踪一个块类型的参数特定分配类型和 filename/linenumber 信息确定分配请求的原点。
_realloc_dbg 与请求的 newSize重新指定的内存块。稍有更多的空间。 newSize 可能大于或小于最初分配的内存块范围。 调试堆管理器用于附加空间链接调试内存块,并提供应用程序提供调试标题信息并复盖缓冲区。 重新分配可能导致将原始内存堆的其他位置,以及更改的范围内存块。 如果发生移动后,原始的块的内容被复盖。
_realloc_dbg 设置 errno 到 ENOMEM ,如果内存分配失败,或如果内存需要的数量 (前面提到的包含开销) 超过 _HEAP_MAXREQ。 有关此更改和其他错误代码的信息,请参见 errno、_doserrno、_sys_errlist和_sys_nerr。
有关如何的信息存储在基堆的调试版本中分配,初始化,并管理,请参见 内存管理和调试堆。 有关分配的信息块类型以及如何使用它们,请参见 调试堆上的块类型。 有关调用标准堆函数之间的差异的信息及其调试在应用程序的调试版本的版本,请参见 使用调试版本与基版本。
要求
实例 |
必需的头 |
---|---|
_realloc_dbg |
crtdbg.h |
有关更多兼容性信息,请参见中介绍的 兼容性 。
库
只调试 C 运行库 的版本。
示例
在 _msize_dbg 参见主题中的示例。
.NET Framework 等效项
不适用。若要调用标准 C 函数,请使用 PInvoke。有关更多信息,请参见 平台调用示例。