三、在脚本中定义日志的输出模式
int lr_debug_message (unsigned int message_level, const char *format, ... );
中文解释:lr_debug_message函数在指定的消息级别处于活动状态时发送一条调试信息。如果指定的消息级别未出于活动状态,则不发送消息。您可以从用户界面或者使用lr_set_debug_message,将处于活动状态的消息级别设置为MSG_CLASS_BRIEF_LOG 或MSG_CLASSS_EXTENDED_LOG。要确定当前级别,请使用lr_get_debug_message。
unsigned int lr_get_debug_message ( );
中文解释:lr_get_debug_message函数返回当前的日志运行时设置。该设置确定发送到输出端的信息。日志设置是使用运行时设置对话框或通过使用lr_set_debug_message函数指定的。
int lr_set_debug_message (unsigned int message_level, unsigned int on_off);
中文解释:lr_set_debug_message函数设置脚本执行的调试消息级别message_lvl。通过设置消息级别,可以确定发送哪些信息。启 动设置的方法是将LR_SWITCH_ON作为on_off传递,禁用设置的方法是传递LR_SWITCH_OFF。
参数message_level说明:
日志级别
C语言标志
值
Runtime-setting - Log操作
Disabled
LR_MSG_CLASS_DISABLE_LOG
0
不勾选Enable logging
Brief
LR_MSG_CLASS_BRIEF_LOG
1
勾选Standard log
Extended Log
LR_MSG_CLASS_EXTENDED_LOG
16
勾选Extended log
Result Data
LR_MSG_CLASS_RESULT_DATA
2
勾选Data returned by server
Parameter Substitution
LR_MSG_CLASS_PARAMETERS
4
勾选Parameter substitution
Full Run-Time Trace
LR_MSG_CLASS_FULL_TRACE
8
勾选 Advanced trace
Only on error
LR_MSG_CLASS_JIT_LOG_ON_ERROR
512
勾选send messages only when an error occurs
参数on_off说明:
【LR_SWITCH_ON】启用设置
【LR_SWITCH_OFF】禁用设置
看下面的小例子:
Action()
{
int log_leavl;
log_leavl = lr_get_debug_message();
lr_error_message ("当前是:%d",log_leavl);
return 0;
}
当我设置只有错误信息(error)打印【勾选send messages only when an error occurs】,例子运行结果是:当前是:513;为什么不是512呢,我发现我实际选择的是【Enable logging + send messages only when an error occurs】,按上面的参数说明,就是【1+512】,也就是513了;因此:lr_get_debug_message返回的int数其实是所有勾选操作的代表值相加!
再看下面设置的例子:
Action()
{
//设置runtime-setting的日志选项【不勾选Enable logging】
char *a;
a = "ABC";
lr_set_debug_message (LR_MSG_CLASS_EXTENDED_LOG |LR_MSG_CLASS_PARAMETERS,LR_SWITCH_ON);
//打开Runtime-setting Log 的Parameter substitution设置
lr_debug_message(LR_MSG_CLASS_PARAMETERS,"打开参数保存的系统日志");
lr_save_string("aa",a);
lr_debug_message(LR_MSG_CLASS_PARAMETERS,"关闭参数保存的系统日志");
lr_set_debug_message (LR_MSG_CLASS_EXTENDED_LOG |LR_MSG_CLASS_PARAMETERS,LR_SWITCH_OFF);
//关闭Runtime-setting Log 的Parameter substitution设置
return 0;
}
因为设置了runtime-setting不打印任何日志,所以正常运行脚本应该没有任何日志输出;但是使用lr_set_debug_message函数打开了日志的设置(输出保存参数操作的日志)因此脚本运行到lr_save_string("aa",a)时,就输出了日志如下:
打开参数保存的系统日志
Action.c(7): Notify: Saving Parameter "ABC = aa"