malloc

 

C

编译器支持

语言

头文件

类型支持

程序工具

变参函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

动态内存管理

malloc

calloc

realloc

free

free_sized (C23)

free_aligned_sized (C23)

aligned_alloc (C11)

 

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

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

如果分配成功，返回一个指针，该指针对于任何具有基本对齐的对象类型都具有适当的对齐。

如果 size 为零，malloc 的行为是实现定义的。例如，可能会返回一个空指针。或者，可能会返回一个非空指针；但此指针不应被解引用，并且应传递给 free 以避免内存泄漏。

malloc 是线程安全的：它的行为就像只访问通过其参数可见的内存位置，而不访问任何静态存储。 之前调用 free、free_sized 和 free_aligned_sized(C23 起) 或 realloc 来解除分配内存区域的操作与调用 malloc 来分配相同或部分相同内存区域的操作进行*同步*。此同步发生在解除分配函数对内存的任何访问之后，以及 malloc 对内存的任何访问之前。所有在特定内存区域上操作的分配和解除分配函数都有一个单一的总顺序。

(C11 起)

参数

size

-

要分配的字节数

返回值

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

失败时，返回空指针。

示例

运行此代码

#include <stdio.h>   
#include <stdlib.h> 
 
int main(void) 
{
    int *p1 = malloc(4*sizeof(int));  // allocates enough for an array of 4 int
    int *p2 = malloc(sizeof(int[4])); // same, naming the type directly
    int *p3 = malloc(4*sizeof *p3);   // same, without repeating the type name
 
    if(p1) {
        for(int n=0; n<4; ++n) // populate the array
            p1[n] = n*n;
        for(int n=0; n<4; ++n) // print it back out
            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 malloc 函数 (p: 254)

• C11 标准 (ISO/IEC 9899:2011)

• 7.22.3.4 malloc 函数 (p: 349)

• C99 标准 (ISO/IEC 9899:1999)

• 7.20.3.3 malloc 函数 (p: 314)

• C89/C90 标准 (ISO/IEC 9899:1990)

• 4.10.3.3 malloc 函数

参阅

free	释放先前分配的内存 (函数)
C++ 文档 关于 malloc