命名空间
变体
操作

malloc

来自 cppreference.com
< c‎ | memory
 
C
 
动态内存管理
 
在头文件 <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 函数

[编辑] 另请参见

 释放先前分配的内存
(函数) [编辑]
C++ 文档 适用于 malloc
检索自 "https://cppreference.cn/mwiki/index.php?title=c/memory/malloc&oldid=157841"