C言語の__func__識別子とは？現在の関数名を取得する方法を解説

C言語には、現在実行中の関数名を自動的に取得できる便利な識別子 __func__ が用意されています。この記事では、__func__ の基本的な使い方と動作について、サンプルコードを交えて解説します。

__func__ 識別子とは

__func__ は、C99規格で標準化された事前定義識別子（predefined identifier）で、その関数内で参照すると「現在の関数名」を文字列リテラルとして返します。

また、古いバージョンのCやC++、GCCなどのコンパイラでは、同等の機能を持つ __FUNCTION__ がサポートされている場合があります。移植性を考慮する場合は、C99以降に準拠した __func__ を使用するのが推奨されます。

サンプルコード

以下の例では、main() 関数と TestFunction() 関数のそれぞれの中で __func__ を参照し、関数名を出力しています。

#include <stdio.h>

void TestFunction() {
    printf("Output of __func__ is: %s\n", __func__);
}

int main() {
    printf("Output of __func__ is: %s\n", __func__);
    TestFunction();
    return 0;
}

実行結果

Output of __func__ is: main
Output of __func__ is: TestFunction

解説

実行結果を見ると、main() 内では main、TestFunction() 内では TestFunction というように、それぞれの関数名が正しく出力されていることがわかります。

__func__ は、以下のような場面で特に役立ちます。

• デバッグログの出力：どの関数からログが出力されたかを自動的に記録できます。
• エラーメッセージの生成：エラー発生箇所の関数名を埋め込むことで、問題の特定が容易になります。
• トレース処理：関数の開始・終了を記録する際に関数名を手動で書く手間を省けます。

なお、__func__ はマクロではなく識別子であるため、プリプロセッサディレクティブ（#ifdef など）の中では使用できない点に注意してください。同様の目的のものとして、ファイル名を返す __FILE__ や行番号を返す __LINE__ といったマクロもあり、これらと組み合わせるとより詳細なデバッグ情報を出力できます。