1. 導入: なぜ__func__が重要なのか
プログラムの開発中、「今どの関数が実行されているのか？」を確認したい場面は非常に多いです。特に複雑な処理や再帰呼び出しを行っているとき、ログ出力のためにわざわざ関数名を文字列として打ち込むのは手間ですし、関数名を変更した際に修正漏れが発生するリスクもあります。
C++の__func__識別子を使えば、コンパイラが自動的に現在の関数名を取得してくれるため、デバッグコードの保守性が劇的に向上します。
2. 基礎知識: __func__とは何か
__func__は、C++の規格（C++11以降）で定義されている「事前定義識別子（predefined identifier）」の一つです。これは定数のように振る舞い、プログラム内で記述された場所の「現在の関数名」をconst char型として保持しています。
あくまで「コンパイラが自動で用意するもの」なので、ユーザー側で変数を宣言したり、値を代入したりする必要はありません。
3. 実装/解決策: ログ出力での活用
もっとも一般的な使い方は、関数が呼ばれたタイミングでログを表示することです。プログラムの入り口に以下のコードを仕込んでおけば、どの処理が実行されたか一目で分かります。
4. サンプルプログラム
以下のコードをコピーして、ご自身の環境で実行してみてください。
include <iostream>
include <string>
void printFunctionName() {
// 現在の関数名「printFunctionName」が文字列として__func__に格納されています
std::cout << "現在実行中の関数: " << __func__ << std::endl;
}
void processData() {
std::cout << "処理を開始します..." << std::endl;
printFunctionName();
}
int main() {
// main関数内では「main」という文字列が取得されます
std::cout << "プログラム開始: " << __func__ << std::endl;
processData();
return 0;
}
5. 応用・注意点: 現場で役立つポイント
・文字列結合の注意点
__func__は文字列リテラル（const char）です。もしstd::stringと連結したい場合は、そのまま足し合わせるだけで問題ありませんが、出力の際は型に注意してください。
・__FUNCTION__との違い
環境によっては__FUNCTION__という名前が使われることもあります。これはもともと多くのコンパイラ（GCCやMSVCなど）が独自拡張として提供していたもので、現在のC++規格では__func__が推奨されています。特別な理由がない限り、__func__を使用するのがベストプラクティスです。
・クラス内での使用
クラスのメンバ関数内で使用すると、そのメンバ関数名が取得されます。クラス名まで含めた詳細な情報を知りたい場合は、コンパイラ固有の機能（__PRETTY_FUNCTION__など）を使う必要がある場合もありますが、まずは基本である__func__を使いこなすことから始めましょう。
コメント