prg_mem_realloc()
摘要
以新的尺寸重新分配一块已存在的通用内存。
语法
prg_mem_realloc (mem_ptr, size)
| 参数 | 类型 | 说明 |
|---|---|---|
mem_ptr |
void * |
待重新分配的现有内存块。 |
size |
size_t |
重新分配所请求的字节数。 |
返回类型
void *
指向重新分配后的内存块的指针。如果重新分配失败,返回 PRGC_NIL。
头文件
prg_mem_funcs.h
示例
/* re-allocate a document request message */
doc_req_msg = (Doc_Req_Msg *) prg_mem_realloc (doc_req_msg,
sizeof (Big_Doc_Req_Msg));
详情
如果未指定内存块(mem_ptr 为 PRGC_NIL),该函数的行为与 prg_mem_alloc() 相同。
如果 size 大于先前分配的内存块,现有内存内容保持不变,新增的空间以零填充。
用途
提供一种以新尺寸动态重新分配内存的机制。该函数类似于 realloc() 函数。
错误
- 可恢复错误:Request to allocate (<size> bytes) of Prg memory failed.
参考
- 使用
prg_mem_free()释放先前分配的内存块 - 使用
prg_mem_copy()复制内存块 - 使用
prg_mem_alloc_dont_clear()分配内存块且不清零