malloc

 

C

语言

头文件

类型支持

程序工具

变参数函数支持

动态内存管理

错误处理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

动态内存管理

malloc

calloc

realloc

free

aligned_alloc (C11)

 

在标头 <stdlib.h> 定义
void* malloc( size_t size );

分配 size 字节的未初始化内存。

若分配成功，则返回为任何拥有基础对齐的对象类型对齐的指针。

若 size 为零，则 malloc 的行为实现是其实现（生成）时定义的。例如可返回空指针。亦可返回非空指针；但不应当解引用这种指针，而且应将它传递给 free 以避免内存泄漏。

malloc 是线程安全的：它表现得如同只访问通过其参数可见的内存区域，而非任何静态存储。 令 free 或 realloc 归还一块内存区域的先前调用，同步于令 malloc 分配相同或部分相同的内存区域的调用。此同步出现于任何通过解分配函数所作的内存访问后，和任何 malloc 所进行的内存访问前。所有操作每块特定内存区域的分配和解分配函数有单独全序。

(C11 起)

参数

size

-

要分配的字节数

返回值

成功时，返回指向新分配内存的指针。为避免内存泄漏，必须用 free() 或 realloc() 解分配返回的指针。

失败时，返回空指针。

示例

运行此代码

#include <stdio.h>   
#include <stdlib.h> 
 
int main(void) 
{
    int *p1 = malloc(4*sizeof(int));  // 足以分配 4 个 int 的数组
    int *p2 = malloc(sizeof(int[4])); // 等价，直接命名数组类型
    int *p3 = malloc(4*sizeof *p3);   // 等价，免去重复类型名
 
    if(p1) {
        for(int n=0; n<4; ++n) // 置入数组
            p1[n] = n*n;
        for(int n=0; n<4; ++n) // 打印出来
            printf("p1[%d] == %d\n", n, p1[n]);
    }
 
    free(p1);
    free(p2);
    free(p3);
}

输出：

p1[0] == 0
p1[1] == 1
p1[2] == 4
p1[3] == 9

引用

• C17 标准（ISO/IEC 9899:2018）：

• 7.22.3.4 The malloc function （第 254 页）

• C11 标准（ISO/IEC 9899:2011）：

• 7.22.3.4 The malloc function （第 349 页）

• C99 标准（ISO/IEC 9899:1999）：

• 7.20.3.3 The malloc function （第 314 页）

• C89/C90 标准（ISO/IEC 9899:1990）：

• 4.10.3.3 The malloc function

参阅

free	归还之前分配的内存 (函数)