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> 字节)失败。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com