事前定義マクロとプラグマ | Programming Place Plus　Ｃ言語編　第２９章

__FILE__ 🔗

__FILE__は、このマクロを使用したソースファイルの名前を表す文字列リテラルに置換されます。

// main.c
#include <stdio.h>

int main(void)
{
    puts(__FILE__);
}

実行結果：

main.c

__FILE__ によって置換された結果は文字列リテラルですから、puts関数に渡せばそのまま出力できます。

なお、ファイル名を強制的に変更する #line指令という命令があり、その影響を受けます。これは後で説明します。

__LINE__ 🔗

__LINE__は、このマクロを使用したファイル上の行の番号を表す整数型の定数に置換されます。

#include <stdio.h>

int main(void)
{
    printf("%d\n", __LINE__);
}

実行結果：

5

なお、行番号を強制的に変更する #line指令という命令があり、その影響を受けます。これは後で説明します。

__DATE__ 🔗

__DATE__は、コンパイルを行ったときの日付に置換されます。置換された結果は文字列リテラルです。

#include <stdio.h>

int main(void)
{
    puts(__DATE__);
}

実行結果：

Mar 11 2023

置換結果は、日付の形式は「月 日 年」の順番であり、間を半角スペースで空けたものです。「月」の部分は asctime関数 と同じ表現になります（asctime関数は、第５１章で取り上げます）。「日」の部分は必ず２桁分の幅を取り、10未満のときは上位桁が空白文字になります^[1]。

__TIME__ 🔗

__TIME__は、コンパイルを行ったときの時刻に置換されます。置換された結果は文字列です。

#include <stdio.h>

int main(void)
{
    puts(__TIME__);
}

実行結果：

13:28:16

時刻の形式は「時:分:秒」の順番で、: で区切られています。24時間形式で表現され、それぞれ 2桁の 10進数です。

__DATE__ と同様に、__TIME__ の表現形式も asctime関数（第５１章）と同じです。

__STDC__ 🔗

__STDC__は、処理系が標準規格に準拠していれば 1 に置換されます。準拠していない場合にどうなるべきなのかは不明です（それを定義していても、それに準拠していないわけですし）。

#include <stdio.h>

int main(void)
{
#ifdef __STDC__
    puts("Conforms to standards.");
#else
    puts("Not standard compliant.");
#endif
}

実行結果（Visual Studio）：

Not standard compliant.

実行結果（gcc）：

Conforms to standards.

Visual Studio と gcc とで実行結果が異なっています。Visual Studio での結果は意外かもしれません。

Visual Studio　では、プロジェクトのプロパティを開き、「構成プロパティ」→「C/C++」→「言語」を選択し、「言語拡張を無効にする」を「はい(/Za)」に変更すれば、__STDC__　が定義されます。

__STDC_VERSION__ 🔗

__STDC_VERSION__ は、処理系がどの標準規格に対応しているかを表す、long int型の定数に置き換わります。

以下の表のようになっています。

【C11】__STDC_VERSION__ の置換結果は 201112L に更新されました。

【C17】__STDC_VERSION__ の置換結果は 201710L に更新されました。

【C23】__STDC_VERSION__ の置換結果は 202311L に更新されました。

#include <stdio.h>

int main(void)
{
#ifdef __STDC_VERSION__
    printf("%ld\n", __STDC_VERSION__);
#else
    printf("__STDC_VERSION__ undefined.\n");
#endif
}

実行結果（Visual Studio）：

__STDC_VERSION__ undefined.

実行結果（gcc 6.4.0 (MinGW-w64)）：

201112

Visual Studio では、__STDC__ の定義の有無とも関係なく、つねに __STDC_VERSION__ は定義されないようです。gcc では、__STDC_VERSION__ が定義されているので、値が出力されます。

Visual Studio ではできませんが、本来的には、__STDC__ の結果と、__STDC_VERSION__ の結果とを組み合わせて、対応規格を知ることができます。

__STDC_HOSTED__ 🔗

__STDC_HOSTED__ は、処理系が、ホスト処理系であれば 1 に、フリースタンディング処理系であれば 0 に置換されます。

ホスト処理系 (hosted implementation) とは、プログラムの実行が OS の支援によって行われる環境のことです。このような環境では、Ｃ言語の標準規格にあるすべての機能が使用できます。

フリースタンディング処理系 (freestanding implementation) とは、OS の支援無しでプログラムが実行される環境で、Ｃ言語の標準規格にある機能の一部しか使用できません。

#include <stdio.h>

int main(void)
{
    printf("%d\n", __STDC_HOSTED__);
}

実行結果 ：

1

__func__ 🔗

__func__は、関数の本体でのみ使用でき、その関数名の文字列リテラルを得られます。より具体的には、関数の冒頭部分に、以下のコードがあるかのようにコンパイルされます。

static const char __func__[] = "関数名";

使用例は以下のようになります。

#include <stdio.h>

void func(void);

int main(void)
{
    puts(__func__);

    func();
}

void func(void)
{
    puts(__func__);
}

実行結果：

main
func