Changes between Version 2 and Version 3 of SrlApi

Timestamp:

Feb 1, 2007, 2:40:36 AM (17 years ago)

Author:

Nicolas Pouillon

Comment:

Log levels

SrlApi

@@ -7 +7 @@
 Log API let you define message levels. Levels allow you to let your debug code in the source, and only compile it when needed.
 
+In order, levels are:
+ * NONE
+ * TRACE
+ * DEBUG
+ * MAX
+
+When writing your software, you decide what level the message is for. When compiling or running you software, you decide what minimal level your code must have to be printed.
+
  * {{{srl_log(level, "message")}}} prints a message
  * {{{srl_log_printf(level, "message_with_format", arguments...)}}} prints a printf-like message
+
+Arguments in printf-like version may be not evaluated if level is not sufficient. Therefore you '''MUST NOT''' put expressions with side effects in the parameter list. ie do '''not''' do this:
+{{{
+srl_log_printf(DEBUG, "i=%d\n", i++);
+}}}
 
 == Mwmr fifos ==