関数setMsgRoute マニュアル

(The documentation of function setMsgRoute)
Last Update: 2023/4/5


◆機能・用途(Purpose)

関数呼び出し直前に用いてメッセージ出力経路に新しい要素を追加する。
Add a new component to message output routes; this function is used immediately before a function call.

◆形式(Format)

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


◆引数(Arguments)

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


◆使用例(Example)

setMsgRoute(__FILE__,__FUNCTION__,__LINE__);
function();
removeMsgRoute();


◆補足(Additional notes)

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