C++/CLIをDoxygenの呼び出し関係図で出力したが出力されない関数がある

Question

社内の既存プロジェクト(C++/CLI)について、ある関数(下記ソース:FuncA)の呼び出し関係図が必要となり、Doxygenの設定を行い、出力を行いました。

Doxygenの実行は成功し、呼び出し関係図も出力されました。
しかし出力ドキュメントのFuncAを確認してみると、コールされている関数のうち、下記ソース中のFuncBが呼び出し関係図に出力されていませんでした。

コールしているものを全て図に出力したいのですが、これによって「何故か出力されない関数がある」ということに気づきました。

FuncBのように出力されないのを回避するには、なにか設定等が必要なのでしょうか？
ご存知の方がいらっしゃいましたら、ご教授頂きたく宜しくお願い致します。

なお、FuncB()自体は、ドキュメントに出力されていました。

ソースコード抜粋

("..."はコードの中略です)
namespace XXX {
	public ref class Form1 : public System::Windows::Forms::Form
	{
		...
		void FuncA(void)
		{
			...
			try {
				...
				while( ... )
				{
					...
					if (...)
					{
						...
					}
					else if( ...)
					{
						if(...)
						{
							...

							if(...)
							{
								if (...)
								{
									FuncB();
								}
							}
							else
							{
								FuncB();
							}
						}
						FuncB();
					}
				}
			}
			...
		}
		...
		void FuncB()
		{
			...
		}
		...
	};
}

Doxyfile変更箇所

EXTRACT_ALL            = YES
EXTRACT_PRIVATE        = YES
EXTRACT_PACKAGE        = YES
EXTRACT_STATIC         = YES
EXTRACT_LOCAL_METHODS  = YES
HAVE_DOT               = YES
CALL_GRAPH             = YES
CALLER_GRAPH           = YES

# 回答を受け変更
DOT_GRAPH_MAX_NODES    = 10000
MAX_DOT_GRAPH_DEPTH    = 1000
CPP_CLI_SUPPORT        = YES

# 別途追加で行った変更
EXTRACT_PRIV_VIRTUAL   = YES
EXTRACT_ANON_NSPACES   = YES

追記

Doxygen 最新版へ

インストールされていたDoxygenが旧Ver(1.8.14)だったため、最新版(1.8.17)にバージョンアップ。
それに伴い、「doxygen -u」でDoxyfileをバージョンアップ。

同クラス内の関数だと出力されない？

Form1が記述されているForm1.hの別の関数をチェックしてみたところ

("..."はコードの中略です)
namespace XXX {
	public ref class Form1 : public System::Windows::Forms::Form
	{
		...
		void FuncX() {...}
		void FuncY() {
			...
			FuncX();
			...
		}
		...
	};
}

のように、FuncA,FuncBと同様なケースの場合、FuncYの呼び出し関係図に、FuncXが表示されていないことがわかりました。

同クラス内の関数をコールしている場合、呼び出し関係図にその関数は記載されないのでしょうか……？

Comments

[t_obara]

DOT_GRAPH_MAX_NODES を 10000とかに設定してみるとどうでしょう？

[lis]

ご回答ありがとうございます。早速試してみました。

DOT_GRAPH_MAX_NODESを50(初期値)→10000とした結果、変化はありませんでした。

下記URLの「DOT_GRAPH_MAX_NODES」説明欄に

> (MAX_DOT_GRAPH_DEPTH でも制限)

とあったため、MAX_DOT_GRAPH_DEPTHを0(初期値)→1000としてみましたが、コチラも変化なしでした。

http://cercopes-z.com/Doxygen/list-config-dxy.html

Answer 1

自己解決しました。

ヘッダ上(クラス定義)に直接処理が書かれている箇所が問題でした。
暫定的な対応策として、調査用の新規クラスに直書き関数のみ移植することで対処しました。

ありがとうございました。

Answer 2

質問の内容自体には特に問題が見当たらないので、憶測なんですが。

プリプロセッサで使用する定義は、ソースコードの中の物しか反映されません。
例えば、

  void FuncA()
  {
#ifdef HOGE
    funcB();
#endif
  }

というような場合、「#ifdef HOGE」の中はソースコードの中で定義されていなければ、解析されません。
このような場合には、「PREDEFINED」で定義してください。

PREDEFINED = HOGE

あと、C++/CLIは知らないのですが、下記のサイトを見ると「CPP_CLI_SUPPORT=YES」が要るかもしれません。

• DoxygenをC++/CLIで使用する。

Comments

[lis]

ご回答ありがとうございます。
念の為ソースを確認してみましたが、FuncB()はプリプロセッサで括られた範囲内ではありませんでした。

とはいえDoxygenを扱うに当たっては、「有効だと思っているプリプロセッサ」には注意が必要なんですね……
ヘッダ等で定義しているプリプロセッサは、別途注意してみます。

「CPP_CLI_SUPPORT=YES」についても試してみましたが、結果は変わらずでした。