awtk/docs/manual/tk_mem_t.md

tk_mem_t

概述

内存管理相关的宏和函数。

示例：

char* str = (char*)TKMEM_ALLOC(100);
...
TKMEM_FREE(str);

char* str = (char*)TKMEM_ALLOC(100);
...
str = (char*)TKMEM_REALLOC(str, 128);
...
TKMEM_FREE(str);

---

函数

函数名称	说明
TKMEM_ALLOC	分配一块内存。
TKMEM_CALLOC	分配一块内存，并将内容清零。
TKMEM_FREE	释放内存。
TKMEM_REALLOC	重新分配一块内存，如果原来的内存块大于等于需要的空间，直接返回原来的内存块。

TKMEM_ALLOC 宏

---

• 函数功能：

分配一块内存。

• 函数原型：

void* TKMEM_ALLOC (uint32_t size);

• 参数说明：

参数	类型	说明
返回值	void*	成功返回内存块首地址，失败返回NULL。
size	uint32_t	内存大小。

TKMEM_CALLOC 宏

---

• 函数功能：

分配一块内存，并将内容清零。

• 函数原型：

void* TKMEM_CALLOC (uint32_t nmemb, uint32_t size);

• 参数说明：

参数	类型	说明
返回值	void*	成功返回内存块首地址，失败返回NULL。
nmemb	uint32_t	内存块数量。
size	uint32_t	每一块的大小。

TKMEM_FREE 宏

---

• 函数功能：

释放内存。

• 函数原型：

void TKMEM_FREE (void* p);

• 参数说明：

参数	类型	说明
返回值	void	无。
p	void*	内存地址。

TKMEM_REALLOC 宏

---

• 函数功能：

重新分配一块内存，如果原来的内存块大于等于需要的空间，直接返回原来的内存块。

• 函数原型：

void* TKMEM_REALLOC (void* p, uint32_t size);

• 参数说明：

参数	类型	说明
返回值	void*	成功返回内存块首地址，失败返回NULL。
p	void*	原来的内存地址。
size	uint32_t	每一块的大小。