関数printMsgRoute マニュアル

(The documentation of function printMsgRoute)

Last Update: 2023/4/5


◆機能・用途(Purpose)

メッセージ出力の直前に用いてメッセージ出力経路を表示する。
Display the message output routes; this function is used immediately before displaying a message.


◆形式(Format)

#include <msg.h>
inline void printMsgRoute
(const char ∗fileName,const char ∗functionName,const int line)


◆引数(Arguments)

fileName メッセージの出力元のプログラムファイル名。通常、__FILE__とする。
The name of the program file from which the message was displayed; usually use __FILE__.
functionName メッセージの出力元の関数名。通常、__FUNCTION__とする。
The name of the function from which the message was displayed; usually use __FUNCTION__.
line 第1引数で指定したファイル内でのメッセージの出力元の行番号。 通常、__LINE__とする。
The line number in the file specified by the 1st argument from which the message was displayed; usually use __LINE__.


◆使用例(Example)

printMsgRoute(__FILE__,__FUNCTION__,__LINE__);
fprintf(stderr,"エラーが発生しました。\n");
fprintf(stderr,"An error occurred.\n");
exit(1);


◆補足(Additional notes)

この関数をプログラム内に直接書く必要はなく、
pRoute;
という短い記述で代用できる。 マクロpRoute参照。
This function needs not be directly written in a program; use a shorter code
pRoute;
instead. See macro pRoute.