malloc

来自cppreference.com
< c‎ | memory
定义于头文件 <stdlib.h>
void* malloc( size_t size );

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

若分配成功,会返回一个指向分配内存块最低位(首位)字节的指针,它适合对齐任何对象类型。

size为零,则行为是实现定义的(可返回空指针,此情况下旧内存块不被释放,或返回不会用于访问存储的非空指针)。

malloc是线程安全的:它表现得如同只访问通过其参数可见的内存区域,而非通过任何静态存储。

先前令freerealloc归还一块内存区域的调用,与令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

[编辑] 参考

  • C11 standard (ISO/IEC 9899:2011):
  • 7.22.3.4 The malloc function (p: 349)
  • C99 standard (ISO/IEC 9899:1999):
  • 7.20.3.3 The malloc function (p: 314)
  • C89/C90 standard (ISO/IEC 9899:1990):
  • 4.10.3.3 The malloc function

[编辑] 参阅

mallocC++文档