NULL

 

C

コンパイラサポート

言語

ヘッダー

型サポート

プログラムユーティリティ

可変長引数関数のサポート

エラーハンドリング

動的メモリ管理

文字列ライブラリ

アルゴリズム

数値

日付と時刻のユーティリティ

入出力サポート

ローカライゼーションサポート

並行処理サポート (C11)

技術仕様

シンボルインデックス

 

型サポート

size_t

ptrdiff_t

nullptr_t (C23)

NULL

max_align_t (C11)

offsetof

数値の限界

固定幅整数型 (C99)

 

ヘッダ <locale.h> で定義
ヘッダー <stddef.h> で定義
ヘッダー <stdio.h> で定義
ヘッダー <stdlib.h> で定義
ヘッダー <string.h> で定義
ヘッダー <time.h> で定義
ヘッダー <wchar.h> で定義
#define NULL /*実装依存*/

マクロNULLは実装依存のヌルポインタ定数であり、以下のいずれかです。

• 整数 定数式で値は​0​
• 整数定数式で値は​0​を型にキャストしたもの void*

事前定義された定数 nullptr

(C23以降)

ヌルポインタ定数は、任意のポインタ型に変換できます。このような変換の結果は、その型のヌルポインタ値になります。

注記

POSIXではNULLは、値が​0​でvoid*にキャストされた整数定数式として定義されることが要求されています。

実装例

// C++ compatible: #define NULL 0 // C++ incompatible: #define NULL (10*2 - 20) #define NULL ((void*)0) // since C23 (compatible with C++11 and later) #define NULL nullptr

例

このコードを実行

#include <inttypes.h>
#include <stdint.h>
#include <stdio.h>
#include <stdlib.h>
 
int main(void)
{
    // any kind of pointer can be set to NULL
    int* p = NULL;
    struct S *s = NULL;
    void(*f)(int, double) = NULL;
    printf("%p %p %p\n", (void*)p, (void*)s, (void*)(long)f);
 
    // many pointer-returning functions use null pointers to indicate error
    char *ptr = malloc(0xFULL);
    if (ptr == NULL)
        printf("Out of memory");
    else
        printf("ptr = %#" PRIxPTR"\n", (uintptr_t)ptr);
    free(ptr);
}

実行結果の例

(nil) (nil) (nil)
ptr = 0xc001cafe

関連

nullptr_t (C23)	事前定義されたヌルポインター定数 nullptr の型 (typedef)
C++ のドキュメント (NULL)