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