op_prg_mem_realloc()
摘要
以新的大小重新分配一块已存在的通用内存。
注意: 该内核过程是一个仅为向后兼容而保留的宏调用。新代码中请使用 prg_mem_realloc()。
语法
op_prg_mem_realloc (mem_ptr, size)
| 参数 | 类型 | 说明 |
|---|---|---|
mem_ptr |
void* |
待重新分配的现有内存块。 |
size |
size_t |
请求重新分配的内存字节数。 |
返回类型
void*
指向重新分配后的内存块的指针。若重新分配失败,返回 OPC_NIL。
这个“通用”指针应被转换为合适的数据类型后再访问。
示例
/* re-allocate the document request message */
doc_req_msg = (Doc_Req_Msg *) op_prg_mem_realloc (doc_req_msg,
sizeof (Big_Doc_Req_Msg));
详情
若未指定内存块(mem_ptr 为 OPC_NIL),该函数的行为与 op_prg_mem_alloc() 相同。
若 size 大于先前分配的内存块,现有内存内容保持不变,新增的空间将以零填充。
用途
提供以新的大小动态重新分配内存的机制。该函数与 realloc() 函数类似。
错误
- 可恢复错误:请求重新分配 Prg 内存(
<size>字节)失败。
参考
- 使用内核过程 op_prg_mem_free() 释放先前已分配的内存块