rcutils  master
C API providing common utilities and data structures.
Macros
logging_macros.h File Reference
#include "rcutils/logging.h"
#include <stdio.h>
#include <stdlib.h>
Include dependency graph for logging_macros.h:

Go to the source code of this file.

Macros

#define RCUTILS_LOG_MIN_SEVERITY   RCUTILS_LOG_SEVERITY_DEBUG
 
#define RCUTILS_LIKELY(x)   __builtin_expect((x), 1)
 
#define RCUTILS_UNLIKELY(x)   __builtin_expect((x), 0)
 
#define RCUTILS_LOGGING_AUTOINIT
 Initialize the rcl logging library. Usually it is unnecessary to call the macro directly. All logging macros ensure that this has been called once. More...
 
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name, ...)
 
#define RCUTILS_LOG_CONDITION_EMPTY
 
Macros for the `once` condition which ignores all subsequent log

calls except the first one.

#define RCUTILS_LOG_CONDITION_ONCE_BEFORE
 
#define RCUTILS_LOG_CONDITION_ONCE_AFTER
 
Macros for the `expression` condition which ignores the log calls

when the expression evaluates to false.

#define RCUTILS_LOG_CONDITION_EXPRESSION_BEFORE(expression)   if (expression) {
 
#define RCUTILS_LOG_CONDITION_EXPRESSION_AFTER   }
 
Macros for the `skipfirst` condition which ignores the first log

call but processes all subsequent calls.

#define RCUTILS_LOG_CONDITION_SKIPFIRST_BEFORE
 
#define RCUTILS_LOG_CONDITION_SKIPFIRST_AFTER
 
Macros for the `throttle` condition which ignores log calls if the

last logged message is not longer ago than the specified duration.

#define RCUTILS_LOG_CONDITION_THROTTLE_BEFORE(time_source_type, duration)
 
#define RCUTILS_LOG_CONDITION_THROTTLE_AFTER
 
Logging macros for severity DEBUG.
#define RCUTILS_LOG_DEBUG(...)
 
#define RCUTILS_LOG_DEBUG_NAMED(name, ...)
 
#define RCUTILS_LOG_DEBUG_ONCE(...)
 
#define RCUTILS_LOG_DEBUG_ONCE_NAMED(name, ...)
 
#define RCUTILS_LOG_DEBUG_EXPRESSION(expression, ...)
 
#define RCUTILS_LOG_DEBUG_EXPRESSION_NAMED(expression, name, ...)
 
#define RCUTILS_LOG_DEBUG_FUNCTION(function, ...)
 
#define RCUTILS_LOG_DEBUG_FUNCTION_NAMED(function, name, ...)
 
#define RCUTILS_LOG_DEBUG_SKIPFIRST(...)
 
#define RCUTILS_LOG_DEBUG_SKIPFIRST_NAMED(name, ...)
 
#define RCUTILS_LOG_DEBUG_THROTTLE(time_source_type, duration, ...)
 
#define RCUTILS_LOG_DEBUG_SKIPFIRST_THROTTLE(time_source_type, duration, ...)
 
#define RCUTILS_LOG_DEBUG_THROTTLE_NAMED(time_source_type, duration, name, ...)
 
#define RCUTILS_LOG_DEBUG_SKIPFIRST_THROTTLE_NAMED(time_source_type, duration, name, ...)
 
Logging macros for severity INFO.
#define RCUTILS_LOG_INFO(...)
 
#define RCUTILS_LOG_INFO_NAMED(name, ...)
 
#define RCUTILS_LOG_INFO_ONCE(...)
 
#define RCUTILS_LOG_INFO_ONCE_NAMED(name, ...)
 
#define RCUTILS_LOG_INFO_EXPRESSION(expression, ...)
 
#define RCUTILS_LOG_INFO_EXPRESSION_NAMED(expression, name, ...)
 
#define RCUTILS_LOG_INFO_FUNCTION(function, ...)
 
#define RCUTILS_LOG_INFO_FUNCTION_NAMED(function, name, ...)
 
#define RCUTILS_LOG_INFO_SKIPFIRST(...)
 
#define RCUTILS_LOG_INFO_SKIPFIRST_NAMED(name, ...)
 
#define RCUTILS_LOG_INFO_THROTTLE(time_source_type, duration, ...)
 
#define RCUTILS_LOG_INFO_SKIPFIRST_THROTTLE(time_source_type, duration, ...)
 
#define RCUTILS_LOG_INFO_THROTTLE_NAMED(time_source_type, duration, name, ...)
 
#define RCUTILS_LOG_INFO_SKIPFIRST_THROTTLE_NAMED(time_source_type, duration, name, ...)
 
Logging macros for severity WARN.
#define RCUTILS_LOG_WARN(...)
 
#define RCUTILS_LOG_WARN_NAMED(name, ...)
 
#define RCUTILS_LOG_WARN_ONCE(...)
 
#define RCUTILS_LOG_WARN_ONCE_NAMED(name, ...)
 
#define RCUTILS_LOG_WARN_EXPRESSION(expression, ...)
 
#define RCUTILS_LOG_WARN_EXPRESSION_NAMED(expression, name, ...)
 
#define RCUTILS_LOG_WARN_FUNCTION(function, ...)
 
#define RCUTILS_LOG_WARN_FUNCTION_NAMED(function, name, ...)
 
#define RCUTILS_LOG_WARN_SKIPFIRST(...)
 
#define RCUTILS_LOG_WARN_SKIPFIRST_NAMED(name, ...)
 
#define RCUTILS_LOG_WARN_THROTTLE(time_source_type, duration, ...)
 
#define RCUTILS_LOG_WARN_SKIPFIRST_THROTTLE(time_source_type, duration, ...)
 
#define RCUTILS_LOG_WARN_THROTTLE_NAMED(time_source_type, duration, name, ...)
 
#define RCUTILS_LOG_WARN_SKIPFIRST_THROTTLE_NAMED(time_source_type, duration, name, ...)
 
Logging macros for severity ERROR.
#define RCUTILS_LOG_ERROR(...)
 
#define RCUTILS_LOG_ERROR_NAMED(name, ...)
 
#define RCUTILS_LOG_ERROR_ONCE(...)
 
#define RCUTILS_LOG_ERROR_ONCE_NAMED(name, ...)
 
#define RCUTILS_LOG_ERROR_EXPRESSION(expression, ...)
 
#define RCUTILS_LOG_ERROR_EXPRESSION_NAMED(expression, name, ...)
 
#define RCUTILS_LOG_ERROR_FUNCTION(function, ...)
 
#define RCUTILS_LOG_ERROR_FUNCTION_NAMED(function, name, ...)
 
#define RCUTILS_LOG_ERROR_SKIPFIRST(...)
 
#define RCUTILS_LOG_ERROR_SKIPFIRST_NAMED(name, ...)
 
#define RCUTILS_LOG_ERROR_THROTTLE(time_source_type, duration, ...)
 
#define RCUTILS_LOG_ERROR_SKIPFIRST_THROTTLE(time_source_type, duration, ...)
 
#define RCUTILS_LOG_ERROR_THROTTLE_NAMED(time_source_type, duration, name, ...)
 
#define RCUTILS_LOG_ERROR_SKIPFIRST_THROTTLE_NAMED(time_source_type, duration, name, ...)
 
Logging macros for severity FATAL.
#define RCUTILS_LOG_FATAL(...)
 
#define RCUTILS_LOG_FATAL_NAMED(name, ...)
 
#define RCUTILS_LOG_FATAL_ONCE(...)
 
#define RCUTILS_LOG_FATAL_ONCE_NAMED(name, ...)
 
#define RCUTILS_LOG_FATAL_EXPRESSION(expression, ...)
 
#define RCUTILS_LOG_FATAL_EXPRESSION_NAMED(expression, name, ...)
 
#define RCUTILS_LOG_FATAL_FUNCTION(function, ...)
 
#define RCUTILS_LOG_FATAL_FUNCTION_NAMED(function, name, ...)
 
#define RCUTILS_LOG_FATAL_SKIPFIRST(...)
 
#define RCUTILS_LOG_FATAL_SKIPFIRST_NAMED(name, ...)
 
#define RCUTILS_LOG_FATAL_THROTTLE(time_source_type, duration, ...)
 
#define RCUTILS_LOG_FATAL_SKIPFIRST_THROTTLE(time_source_type, duration, ...)
 
#define RCUTILS_LOG_FATAL_THROTTLE_NAMED(time_source_type, duration, name, ...)
 
#define RCUTILS_LOG_FATAL_SKIPFIRST_THROTTLE_NAMED(time_source_type, duration, name, ...)
 

Macros for the `function` condition which ignores the log calls

when the function returns false.

#define RCUTILS_LOG_CONDITION_FUNCTION_BEFORE(function)   if ((*function)()) {
 
#define RCUTILS_LOG_CONDITION_FUNCTION_AFTER   }
 
typedef bool(* RclLogFilter) ()
 

Macro Definition Documentation

#define RCUTILS_LOG_MIN_SEVERITY   RCUTILS_LOG_SEVERITY_DEBUG

Define RCUTILS_LOG_MIN_SEVERITY=RCUTILS_LOG_SEVERITY_[DEBUG|INFO|WARN|ERROR|FATAL] in your build options to compile out anything below that severity.

#define RCUTILS_LIKELY (   x)    __builtin_expect((x), 1)

Instruct the compiler to optimize for the case where the argument equals 1.

#define RCUTILS_UNLIKELY (   x)    __builtin_expect((x), 0)

Instruct the compiler to optimize for the case where the argument equals 0.

#define RCUTILS_LOGGING_AUTOINIT
Value:
}
#define RCUTILS_UNLIKELY(x)
Definition: logging_macros.h:52
bool g_rcl_logging_initialized
The flag if the logging system has been initialized.
void rcl_logging_initialize()
Initialize the logging system.

Initialize the rcl logging library. Usually it is unnecessary to call the macro directly. All logging macros ensure that this has been called once.

#define RCUTILS_LOG_COND_NAMED (   severity,
  condition_before,
  condition_after,
  name,
  ... 
)
Value:
{ \
RCUTILS_LOGGING_AUTOINIT \
static rcl_log_location_t __rcutils_logging_location = {__func__, __FILE__, __LINE__}; \
condition_before \
rcl_log(&__rcutils_logging_location, severity, name, __VA_ARGS__); \
} \
condition_after \
}
int g_rcl_logging_severity_threshold
The global severity threshold before calling the output handler.
void rcl_log(rcl_log_location_t *location, int severity, const char *name, const char *format,...)
Log a message.
The structure identifying the caller location in the source code.
Definition: logging.h:49

The logging macro all other logging macros call directly or indirectly.

Parameters
severityThe severity level
condition_beforeThe condition macro(s) inserted before the log call
condition_afterThe condition macro(s) inserted after the log call
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_CONDITION_EMPTY

An empty macro which can be used as a placeholder for condition_before and condition_after which doesn't affect the logging call.

#define RCUTILS_LOG_CONDITION_ONCE_BEFORE
Value:
{ \
static int __rcutils_logging_once = 0; \
if (RCUTILS_UNLIKELY(0 == __rcutils_logging_once)) { \
__rcutils_logging_once = 1;
#define RCUTILS_UNLIKELY(x)
Definition: logging_macros.h:52

A macro initializing and checking the once condition.

#define RCUTILS_LOG_CONDITION_ONCE_AFTER
Value:
} \
}

A macro finalizing the once condition.

#define RCUTILS_LOG_CONDITION_EXPRESSION_BEFORE (   expression)    if (expression) {

A macro checking the expression condition.

#define RCUTILS_LOG_CONDITION_EXPRESSION_AFTER   }

A macro finalizing the expression condition.

#define RCUTILS_LOG_CONDITION_FUNCTION_BEFORE (   function)    if ((*function)()) {

A macro checking the function condition.

#define RCUTILS_LOG_CONDITION_FUNCTION_AFTER   }

A macro finalizing the function condition.

#define RCUTILS_LOG_CONDITION_SKIPFIRST_BEFORE
Value:
{ \
static bool __rcutils_logging_first = true; \
if (RCUTILS_UNLIKELY(true == __rcutils_logging_first)) { \
__rcutils_logging_first = false; \
} else {
#define RCUTILS_UNLIKELY(x)
Definition: logging_macros.h:52

A macro initializing and checking the skipfirst condition.

#define RCUTILS_LOG_CONDITION_SKIPFIRST_AFTER
Value:
} \
}

A macro finalizing the skipfirst condition.

#define RCUTILS_LOG_CONDITION_THROTTLE_BEFORE (   time_source_type,
  duration 
)
Value:
{ \
static rcutils_duration_value_t __rcutils_logging_duration = RCUTILS_MS_TO_NS((rcutils_duration_value_t)duration); \
static rcutils_time_point_value_t __rcutils_logging_last_logged = 0; \
rcutils_time_point_value_t __rcutils_logging_now = 0; \
bool __rcutils_logging_condition = true; \
if (rcutils_steady_time_now(&__rcutils_logging_now) != RCUTILS_RET_OK) { \
&__rcutils_logging_location, RCUTILS_LOG_SEVERITY_ERROR, "", \
"%s() at %s:%d getting current steady time failed\n", \
__func__, __FILE__, __LINE__); \
} else { \
__rcutils_logging_condition = __rcutils_logging_now >= __rcutils_logging_last_logged + __rcutils_logging_duration; \
} \
\
if (RCUTILS_LIKELY(__rcutils_logging_condition)) { \
__rcutils_logging_last_logged = __rcutils_logging_now;
#define RCUTILS_MS_TO_NS(milliseconds)
Convenience macro to convert milliseconds to nanoseconds.
Definition: time.h:32
int64_t rcutils_duration_value_t
A duration of time, measured in nanoseconds.
Definition: time.h:46
rcutils_ret_t rcutils_steady_time_now(rcutils_time_point_value_t *now)
Retrieve the current time as a rcutils_time_point_value_t object.
void rcl_log(rcl_log_location_t *location, int severity, const char *name, const char *format,...)
Log a message.
#define RCUTILS_RET_OK
Definition: rcutils_ret.h:24
#define RCUTILS_LIKELY(x)
Definition: logging_macros.h:47
The error log level.
Definition: logging.h:65
uint64_t rcutils_time_point_value_t
A single point in time, measured in nanoseconds since the Unix epoch.
Definition: time.h:44

A macro initializing and checking the throttle condition.

#define RCUTILS_LOG_CONDITION_THROTTLE_AFTER
Value:
} \
}

A macro finalizing the throttle condition.

#define RCUTILS_LOG_DEBUG (   ...)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_EMPTY
Definition: logging_macros.h:103
The debug log level.
Definition: logging.h:62

Log a message with severity DEBUG.

Parameters
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_DEBUG_NAMED (   name,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_EMPTY
Definition: logging_macros.h:103
The debug log level.
Definition: logging.h:62

Log a message with severity DEBUG.

Parameters
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_DEBUG_ONCE (   ...)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_ONCE_BEFORE
Definition: logging_macros.h:114
#define RCUTILS_LOG_CONDITION_ONCE_AFTER
Definition: logging_macros.h:123
The debug log level.
Definition: logging.h:62

Log a message with severity DEBUG with the following conditions: All subsequent log calls except the first one are being ignored.

Parameters
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_DEBUG_ONCE_NAMED (   name,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_ONCE_BEFORE
Definition: logging_macros.h:114
#define RCUTILS_LOG_CONDITION_ONCE_AFTER
Definition: logging_macros.h:123
The debug log level.
Definition: logging.h:62

Log a message with severity DEBUG with the following conditions: All subsequent log calls except the first one are being ignored.

Parameters
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_DEBUG_EXPRESSION (   expression,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_EXPRESSION_BEFORE(expression)
Definition: logging_macros.h:135
#define RCUTILS_LOG_CONDITION_EXPRESSION_AFTER
Definition: logging_macros.h:141
The debug log level.
Definition: logging.h:62

Log a message with severity DEBUG with the following conditions: Log calls are being ignored when the expression evaluates to false.

Parameters
expressionThe expression determining if the message should be logged
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_DEBUG_EXPRESSION_NAMED (   expression,
  name,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_EXPRESSION_BEFORE(expression)
Definition: logging_macros.h:135
#define RCUTILS_LOG_CONDITION_EXPRESSION_AFTER
Definition: logging_macros.h:141
The debug log level.
Definition: logging.h:62

Log a message with severity DEBUG with the following conditions: Log calls are being ignored when the expression evaluates to false. All subsequent log calls except the first one are being ignored.

Parameters
expressionThe expression determining if the message should be logged
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_DEBUG_FUNCTION (   function,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_FUNCTION_AFTER
Definition: logging_macros.h:163
#define RCUTILS_LOG_CONDITION_FUNCTION_BEFORE(function)
Definition: logging_macros.h:157
The debug log level.
Definition: logging.h:62

Log a message with severity DEBUG with the following conditions: Log calls are being ignored when the function returns false.

Parameters
functionThe functions return value determines if the message should be logged
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_DEBUG_FUNCTION_NAMED (   function,
  name,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_FUNCTION_AFTER
Definition: logging_macros.h:163
#define RCUTILS_LOG_CONDITION_FUNCTION_BEFORE(function)
Definition: logging_macros.h:157
The debug log level.
Definition: logging.h:62

Log a message with severity DEBUG with the following conditions: Log calls are being ignored when the function returns false. All subsequent log calls except the first one are being ignored.

Parameters
functionThe functions return value determines if the message should be logged
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_DEBUG_SKIPFIRST (   ...)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_SKIPFIRST_BEFORE
Definition: logging_macros.h:174
#define RCUTILS_LOG_CONDITION_SKIPFIRST_AFTER
Definition: logging_macros.h:184
The debug log level.
Definition: logging.h:62

Log a message with severity DEBUG with the following conditions: The first log call is being ignored but all subsequent calls are being processed.

Parameters
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_DEBUG_SKIPFIRST_NAMED (   name,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_SKIPFIRST_BEFORE
Definition: logging_macros.h:174
#define RCUTILS_LOG_CONDITION_SKIPFIRST_AFTER
Definition: logging_macros.h:184
The debug log level.
Definition: logging.h:62

Log a message with severity DEBUG with the following conditions: The first log call is being ignored but all subsequent calls are being processed.

Parameters
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_DEBUG_THROTTLE (   time_source_type,
  duration,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_CONDITION_THROTTLE_BEFORE(time_source_type, duration)
Definition: logging_macros.h:196
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_THROTTLE_AFTER
Definition: logging_macros.h:217
The debug log level.
Definition: logging.h:62

Log a message with severity DEBUG with the following conditions: Log calls are being ignored if the last logged message is not longer ago than the specified duration.

Parameters
time_source_typeThe time source type of the time to be used
durationThe duration of the throttle interval
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_DEBUG_SKIPFIRST_THROTTLE (   time_source_type,
  duration,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_CONDITION_THROTTLE_BEFORE(time_source_type, duration)
Definition: logging_macros.h:196
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_THROTTLE_AFTER
Definition: logging_macros.h:217
#define RCUTILS_LOG_CONDITION_SKIPFIRST_BEFORE
Definition: logging_macros.h:174
#define RCUTILS_LOG_CONDITION_SKIPFIRST_AFTER
Definition: logging_macros.h:184
The debug log level.
Definition: logging.h:62

Log a message with severity DEBUG with the following conditions: The first log call is being ignored but all subsequent calls are being processed. Log calls are being ignored if the last logged message is not longer ago than the specified duration.

Parameters
time_source_typeThe time source type of the time to be used
durationThe duration of the throttle interval
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_DEBUG_THROTTLE_NAMED (   time_source_type,
  duration,
  name,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_CONDITION_THROTTLE_BEFORE(time_source_type, duration)
Definition: logging_macros.h:196
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_THROTTLE_AFTER
Definition: logging_macros.h:217
The debug log level.
Definition: logging.h:62

Log a message with severity DEBUG with the following conditions: Log calls are being ignored if the last logged message is not longer ago than the specified duration.

Parameters
time_source_typeThe time source type of the time to be used
durationThe duration of the throttle interval
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_DEBUG_SKIPFIRST_THROTTLE_NAMED (   time_source_type,
  duration,
  name,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_CONDITION_THROTTLE_BEFORE(time_source_type, duration)
Definition: logging_macros.h:196
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_THROTTLE_AFTER
Definition: logging_macros.h:217
#define RCUTILS_LOG_CONDITION_SKIPFIRST_BEFORE
Definition: logging_macros.h:174
#define RCUTILS_LOG_CONDITION_SKIPFIRST_AFTER
Definition: logging_macros.h:184
The debug log level.
Definition: logging.h:62

Log a message with severity DEBUG with the following conditions: The first log call is being ignored but all subsequent calls are being processed. Log calls are being ignored if the last logged message is not longer ago than the specified duration.

Parameters
time_source_typeThe time source type of the time to be used
durationThe duration of the throttle interval
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_INFO (   ...)
Value:
__VA_ARGS__)
The info log level.
Definition: logging.h:63
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_EMPTY
Definition: logging_macros.h:103

Log a message with severity INFO.

Parameters
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_INFO_NAMED (   name,
  ... 
)
Value:
__VA_ARGS__)
The info log level.
Definition: logging.h:63
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_EMPTY
Definition: logging_macros.h:103

Log a message with severity INFO.

Parameters
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_INFO_ONCE (   ...)
Value:
__VA_ARGS__)
The info log level.
Definition: logging.h:63
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_ONCE_BEFORE
Definition: logging_macros.h:114
#define RCUTILS_LOG_CONDITION_ONCE_AFTER
Definition: logging_macros.h:123

Log a message with severity INFO with the following conditions: All subsequent log calls except the first one are being ignored.

Parameters
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_INFO_ONCE_NAMED (   name,
  ... 
)
Value:
__VA_ARGS__)
The info log level.
Definition: logging.h:63
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_ONCE_BEFORE
Definition: logging_macros.h:114
#define RCUTILS_LOG_CONDITION_ONCE_AFTER
Definition: logging_macros.h:123

Log a message with severity INFO with the following conditions: All subsequent log calls except the first one are being ignored.

Parameters
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_INFO_EXPRESSION (   expression,
  ... 
)
Value:
__VA_ARGS__)
The info log level.
Definition: logging.h:63
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_EXPRESSION_BEFORE(expression)
Definition: logging_macros.h:135
#define RCUTILS_LOG_CONDITION_EXPRESSION_AFTER
Definition: logging_macros.h:141

Log a message with severity INFO with the following conditions: Log calls are being ignored when the expression evaluates to false.

Parameters
expressionThe expression determining if the message should be logged
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_INFO_EXPRESSION_NAMED (   expression,
  name,
  ... 
)
Value:
__VA_ARGS__)
The info log level.
Definition: logging.h:63
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_EXPRESSION_BEFORE(expression)
Definition: logging_macros.h:135
#define RCUTILS_LOG_CONDITION_EXPRESSION_AFTER
Definition: logging_macros.h:141

Log a message with severity INFO with the following conditions: Log calls are being ignored when the expression evaluates to false. All subsequent log calls except the first one are being ignored.

Parameters
expressionThe expression determining if the message should be logged
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_INFO_FUNCTION (   function,
  ... 
)
Value:
__VA_ARGS__)
The info log level.
Definition: logging.h:63
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_FUNCTION_AFTER
Definition: logging_macros.h:163
#define RCUTILS_LOG_CONDITION_FUNCTION_BEFORE(function)
Definition: logging_macros.h:157

Log a message with severity INFO with the following conditions: Log calls are being ignored when the function returns false.

Parameters
functionThe functions return value determines if the message should be logged
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_INFO_FUNCTION_NAMED (   function,
  name,
  ... 
)
Value:
__VA_ARGS__)
The info log level.
Definition: logging.h:63
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_FUNCTION_AFTER
Definition: logging_macros.h:163
#define RCUTILS_LOG_CONDITION_FUNCTION_BEFORE(function)
Definition: logging_macros.h:157

Log a message with severity INFO with the following conditions: Log calls are being ignored when the function returns false. All subsequent log calls except the first one are being ignored.

Parameters
functionThe functions return value determines if the message should be logged
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_INFO_SKIPFIRST (   ...)
Value:
__VA_ARGS__)
The info log level.
Definition: logging.h:63
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_SKIPFIRST_BEFORE
Definition: logging_macros.h:174
#define RCUTILS_LOG_CONDITION_SKIPFIRST_AFTER
Definition: logging_macros.h:184

Log a message with severity INFO with the following conditions: The first log call is being ignored but all subsequent calls are being processed.

Parameters
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_INFO_SKIPFIRST_NAMED (   name,
  ... 
)
Value:
__VA_ARGS__)
The info log level.
Definition: logging.h:63
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_SKIPFIRST_BEFORE
Definition: logging_macros.h:174
#define RCUTILS_LOG_CONDITION_SKIPFIRST_AFTER
Definition: logging_macros.h:184

Log a message with severity INFO with the following conditions: The first log call is being ignored but all subsequent calls are being processed.

Parameters
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_INFO_THROTTLE (   time_source_type,
  duration,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_CONDITION_THROTTLE_BEFORE(time_source_type, duration)
Definition: logging_macros.h:196
The info log level.
Definition: logging.h:63
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_THROTTLE_AFTER
Definition: logging_macros.h:217

Log a message with severity INFO with the following conditions: Log calls are being ignored if the last logged message is not longer ago than the specified duration.

Parameters
time_source_typeThe time source type of the time to be used
durationThe duration of the throttle interval
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_INFO_SKIPFIRST_THROTTLE (   time_source_type,
  duration,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_CONDITION_THROTTLE_BEFORE(time_source_type, duration)
Definition: logging_macros.h:196
The info log level.
Definition: logging.h:63
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_THROTTLE_AFTER
Definition: logging_macros.h:217
#define RCUTILS_LOG_CONDITION_SKIPFIRST_BEFORE
Definition: logging_macros.h:174
#define RCUTILS_LOG_CONDITION_SKIPFIRST_AFTER
Definition: logging_macros.h:184

Log a message with severity INFO with the following conditions: The first log call is being ignored but all subsequent calls are being processed. Log calls are being ignored if the last logged message is not longer ago than the specified duration.

Parameters
time_source_typeThe time source type of the time to be used
durationThe duration of the throttle interval
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_INFO_THROTTLE_NAMED (   time_source_type,
  duration,
  name,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_CONDITION_THROTTLE_BEFORE(time_source_type, duration)
Definition: logging_macros.h:196
The info log level.
Definition: logging.h:63
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_THROTTLE_AFTER
Definition: logging_macros.h:217

Log a message with severity INFO with the following conditions: Log calls are being ignored if the last logged message is not longer ago than the specified duration.

Parameters
time_source_typeThe time source type of the time to be used
durationThe duration of the throttle interval
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_INFO_SKIPFIRST_THROTTLE_NAMED (   time_source_type,
  duration,
  name,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_CONDITION_THROTTLE_BEFORE(time_source_type, duration)
Definition: logging_macros.h:196
The info log level.
Definition: logging.h:63
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_THROTTLE_AFTER
Definition: logging_macros.h:217
#define RCUTILS_LOG_CONDITION_SKIPFIRST_BEFORE
Definition: logging_macros.h:174
#define RCUTILS_LOG_CONDITION_SKIPFIRST_AFTER
Definition: logging_macros.h:184

Log a message with severity INFO with the following conditions: The first log call is being ignored but all subsequent calls are being processed. Log calls are being ignored if the last logged message is not longer ago than the specified duration.

Parameters
time_source_typeThe time source type of the time to be used
durationThe duration of the throttle interval
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_WARN (   ...)
Value:
__VA_ARGS__)
The warn log level.
Definition: logging.h:64
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_EMPTY
Definition: logging_macros.h:103

Log a message with severity WARN.

Parameters
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_WARN_NAMED (   name,
  ... 
)
Value:
__VA_ARGS__)
The warn log level.
Definition: logging.h:64
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_EMPTY
Definition: logging_macros.h:103

Log a message with severity WARN.

Parameters
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_WARN_ONCE (   ...)
Value:
__VA_ARGS__)
The warn log level.
Definition: logging.h:64
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_ONCE_BEFORE
Definition: logging_macros.h:114
#define RCUTILS_LOG_CONDITION_ONCE_AFTER
Definition: logging_macros.h:123

Log a message with severity WARN with the following conditions: All subsequent log calls except the first one are being ignored.

Parameters
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_WARN_ONCE_NAMED (   name,
  ... 
)
Value:
__VA_ARGS__)
The warn log level.
Definition: logging.h:64
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_ONCE_BEFORE
Definition: logging_macros.h:114
#define RCUTILS_LOG_CONDITION_ONCE_AFTER
Definition: logging_macros.h:123

Log a message with severity WARN with the following conditions: All subsequent log calls except the first one are being ignored.

Parameters
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_WARN_EXPRESSION (   expression,
  ... 
)
Value:
__VA_ARGS__)
The warn log level.
Definition: logging.h:64
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_EXPRESSION_BEFORE(expression)
Definition: logging_macros.h:135
#define RCUTILS_LOG_CONDITION_EXPRESSION_AFTER
Definition: logging_macros.h:141

Log a message with severity WARN with the following conditions: Log calls are being ignored when the expression evaluates to false.

Parameters
expressionThe expression determining if the message should be logged
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_WARN_EXPRESSION_NAMED (   expression,
  name,
  ... 
)
Value:
__VA_ARGS__)
The warn log level.
Definition: logging.h:64
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_EXPRESSION_BEFORE(expression)
Definition: logging_macros.h:135
#define RCUTILS_LOG_CONDITION_EXPRESSION_AFTER
Definition: logging_macros.h:141

Log a message with severity WARN with the following conditions: Log calls are being ignored when the expression evaluates to false. All subsequent log calls except the first one are being ignored.

Parameters
expressionThe expression determining if the message should be logged
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_WARN_FUNCTION (   function,
  ... 
)
Value:
__VA_ARGS__)
The warn log level.
Definition: logging.h:64
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_FUNCTION_AFTER
Definition: logging_macros.h:163
#define RCUTILS_LOG_CONDITION_FUNCTION_BEFORE(function)
Definition: logging_macros.h:157

Log a message with severity WARN with the following conditions: Log calls are being ignored when the function returns false.

Parameters
functionThe functions return value determines if the message should be logged
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_WARN_FUNCTION_NAMED (   function,
  name,
  ... 
)
Value:
__VA_ARGS__)
The warn log level.
Definition: logging.h:64
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_FUNCTION_AFTER
Definition: logging_macros.h:163
#define RCUTILS_LOG_CONDITION_FUNCTION_BEFORE(function)
Definition: logging_macros.h:157

Log a message with severity WARN with the following conditions: Log calls are being ignored when the function returns false. All subsequent log calls except the first one are being ignored.

Parameters
functionThe functions return value determines if the message should be logged
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_WARN_SKIPFIRST (   ...)
Value:
__VA_ARGS__)
The warn log level.
Definition: logging.h:64
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_SKIPFIRST_BEFORE
Definition: logging_macros.h:174
#define RCUTILS_LOG_CONDITION_SKIPFIRST_AFTER
Definition: logging_macros.h:184

Log a message with severity WARN with the following conditions: The first log call is being ignored but all subsequent calls are being processed.

Parameters
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_WARN_SKIPFIRST_NAMED (   name,
  ... 
)
Value:
__VA_ARGS__)
The warn log level.
Definition: logging.h:64
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_SKIPFIRST_BEFORE
Definition: logging_macros.h:174
#define RCUTILS_LOG_CONDITION_SKIPFIRST_AFTER
Definition: logging_macros.h:184

Log a message with severity WARN with the following conditions: The first log call is being ignored but all subsequent calls are being processed.

Parameters
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_WARN_THROTTLE (   time_source_type,
  duration,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_CONDITION_THROTTLE_BEFORE(time_source_type, duration)
Definition: logging_macros.h:196
The warn log level.
Definition: logging.h:64
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_THROTTLE_AFTER
Definition: logging_macros.h:217

Log a message with severity WARN with the following conditions: Log calls are being ignored if the last logged message is not longer ago than the specified duration.

Parameters
time_source_typeThe time source type of the time to be used
durationThe duration of the throttle interval
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_WARN_SKIPFIRST_THROTTLE (   time_source_type,
  duration,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_CONDITION_THROTTLE_BEFORE(time_source_type, duration)
Definition: logging_macros.h:196
The warn log level.
Definition: logging.h:64
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_THROTTLE_AFTER
Definition: logging_macros.h:217
#define RCUTILS_LOG_CONDITION_SKIPFIRST_BEFORE
Definition: logging_macros.h:174
#define RCUTILS_LOG_CONDITION_SKIPFIRST_AFTER
Definition: logging_macros.h:184

Log a message with severity WARN with the following conditions: The first log call is being ignored but all subsequent calls are being processed. Log calls are being ignored if the last logged message is not longer ago than the specified duration.

Parameters
time_source_typeThe time source type of the time to be used
durationThe duration of the throttle interval
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_WARN_THROTTLE_NAMED (   time_source_type,
  duration,
  name,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_CONDITION_THROTTLE_BEFORE(time_source_type, duration)
Definition: logging_macros.h:196
The warn log level.
Definition: logging.h:64
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_THROTTLE_AFTER
Definition: logging_macros.h:217

Log a message with severity WARN with the following conditions: Log calls are being ignored if the last logged message is not longer ago than the specified duration.

Parameters
time_source_typeThe time source type of the time to be used
durationThe duration of the throttle interval
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_WARN_SKIPFIRST_THROTTLE_NAMED (   time_source_type,
  duration,
  name,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_CONDITION_THROTTLE_BEFORE(time_source_type, duration)
Definition: logging_macros.h:196
The warn log level.
Definition: logging.h:64
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_THROTTLE_AFTER
Definition: logging_macros.h:217
#define RCUTILS_LOG_CONDITION_SKIPFIRST_BEFORE
Definition: logging_macros.h:174
#define RCUTILS_LOG_CONDITION_SKIPFIRST_AFTER
Definition: logging_macros.h:184

Log a message with severity WARN with the following conditions: The first log call is being ignored but all subsequent calls are being processed. Log calls are being ignored if the last logged message is not longer ago than the specified duration.

Parameters
time_source_typeThe time source type of the time to be used
durationThe duration of the throttle interval
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_ERROR (   ...)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_EMPTY
Definition: logging_macros.h:103
The error log level.
Definition: logging.h:65

Log a message with severity ERROR.

Parameters
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_ERROR_NAMED (   name,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_EMPTY
Definition: logging_macros.h:103
The error log level.
Definition: logging.h:65

Log a message with severity ERROR.

Parameters
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_ERROR_ONCE (   ...)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_ONCE_BEFORE
Definition: logging_macros.h:114
#define RCUTILS_LOG_CONDITION_ONCE_AFTER
Definition: logging_macros.h:123
The error log level.
Definition: logging.h:65

Log a message with severity ERROR with the following conditions: All subsequent log calls except the first one are being ignored.

Parameters
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_ERROR_ONCE_NAMED (   name,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_ONCE_BEFORE
Definition: logging_macros.h:114
#define RCUTILS_LOG_CONDITION_ONCE_AFTER
Definition: logging_macros.h:123
The error log level.
Definition: logging.h:65

Log a message with severity ERROR with the following conditions: All subsequent log calls except the first one are being ignored.

Parameters
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_ERROR_EXPRESSION (   expression,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_EXPRESSION_BEFORE(expression)
Definition: logging_macros.h:135
#define RCUTILS_LOG_CONDITION_EXPRESSION_AFTER
Definition: logging_macros.h:141
The error log level.
Definition: logging.h:65

Log a message with severity ERROR with the following conditions: Log calls are being ignored when the expression evaluates to false.

Parameters
expressionThe expression determining if the message should be logged
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_ERROR_EXPRESSION_NAMED (   expression,
  name,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_EXPRESSION_BEFORE(expression)
Definition: logging_macros.h:135
#define RCUTILS_LOG_CONDITION_EXPRESSION_AFTER
Definition: logging_macros.h:141
The error log level.
Definition: logging.h:65

Log a message with severity ERROR with the following conditions: Log calls are being ignored when the expression evaluates to false. All subsequent log calls except the first one are being ignored.

Parameters
expressionThe expression determining if the message should be logged
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_ERROR_FUNCTION (   function,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_FUNCTION_AFTER
Definition: logging_macros.h:163
#define RCUTILS_LOG_CONDITION_FUNCTION_BEFORE(function)
Definition: logging_macros.h:157
The error log level.
Definition: logging.h:65

Log a message with severity ERROR with the following conditions: Log calls are being ignored when the function returns false.

Parameters
functionThe functions return value determines if the message should be logged
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_ERROR_FUNCTION_NAMED (   function,
  name,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_FUNCTION_AFTER
Definition: logging_macros.h:163
#define RCUTILS_LOG_CONDITION_FUNCTION_BEFORE(function)
Definition: logging_macros.h:157
The error log level.
Definition: logging.h:65

Log a message with severity ERROR with the following conditions: Log calls are being ignored when the function returns false. All subsequent log calls except the first one are being ignored.

Parameters
functionThe functions return value determines if the message should be logged
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_ERROR_SKIPFIRST (   ...)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_SKIPFIRST_BEFORE
Definition: logging_macros.h:174
#define RCUTILS_LOG_CONDITION_SKIPFIRST_AFTER
Definition: logging_macros.h:184
The error log level.
Definition: logging.h:65

Log a message with severity ERROR with the following conditions: The first log call is being ignored but all subsequent calls are being processed.

Parameters
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_ERROR_SKIPFIRST_NAMED (   name,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_SKIPFIRST_BEFORE
Definition: logging_macros.h:174
#define RCUTILS_LOG_CONDITION_SKIPFIRST_AFTER
Definition: logging_macros.h:184
The error log level.
Definition: logging.h:65

Log a message with severity ERROR with the following conditions: The first log call is being ignored but all subsequent calls are being processed.

Parameters
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_ERROR_THROTTLE (   time_source_type,
  duration,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_CONDITION_THROTTLE_BEFORE(time_source_type, duration)
Definition: logging_macros.h:196
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_THROTTLE_AFTER
Definition: logging_macros.h:217
The error log level.
Definition: logging.h:65

Log a message with severity ERROR with the following conditions: Log calls are being ignored if the last logged message is not longer ago than the specified duration.

Parameters
time_source_typeThe time source type of the time to be used
durationThe duration of the throttle interval
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_ERROR_SKIPFIRST_THROTTLE (   time_source_type,
  duration,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_CONDITION_THROTTLE_BEFORE(time_source_type, duration)
Definition: logging_macros.h:196
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_THROTTLE_AFTER
Definition: logging_macros.h:217
#define RCUTILS_LOG_CONDITION_SKIPFIRST_BEFORE
Definition: logging_macros.h:174
#define RCUTILS_LOG_CONDITION_SKIPFIRST_AFTER
Definition: logging_macros.h:184
The error log level.
Definition: logging.h:65

Log a message with severity ERROR with the following conditions: The first log call is being ignored but all subsequent calls are being processed. Log calls are being ignored if the last logged message is not longer ago than the specified duration.

Parameters
time_source_typeThe time source type of the time to be used
durationThe duration of the throttle interval
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_ERROR_THROTTLE_NAMED (   time_source_type,
  duration,
  name,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_CONDITION_THROTTLE_BEFORE(time_source_type, duration)
Definition: logging_macros.h:196
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_THROTTLE_AFTER
Definition: logging_macros.h:217
The error log level.
Definition: logging.h:65

Log a message with severity ERROR with the following conditions: Log calls are being ignored if the last logged message is not longer ago than the specified duration.

Parameters
time_source_typeThe time source type of the time to be used
durationThe duration of the throttle interval
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_ERROR_SKIPFIRST_THROTTLE_NAMED (   time_source_type,
  duration,
  name,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_CONDITION_THROTTLE_BEFORE(time_source_type, duration)
Definition: logging_macros.h:196
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_THROTTLE_AFTER
Definition: logging_macros.h:217
#define RCUTILS_LOG_CONDITION_SKIPFIRST_BEFORE
Definition: logging_macros.h:174
#define RCUTILS_LOG_CONDITION_SKIPFIRST_AFTER
Definition: logging_macros.h:184
The error log level.
Definition: logging.h:65

Log a message with severity ERROR with the following conditions: The first log call is being ignored but all subsequent calls are being processed. Log calls are being ignored if the last logged message is not longer ago than the specified duration.

Parameters
time_source_typeThe time source type of the time to be used
durationThe duration of the throttle interval
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_FATAL (   ...)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_EMPTY
Definition: logging_macros.h:103
The fatal log level.
Definition: logging.h:66

Log a message with severity FATAL.

Parameters
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_FATAL_NAMED (   name,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_EMPTY
Definition: logging_macros.h:103
The fatal log level.
Definition: logging.h:66

Log a message with severity FATAL.

Parameters
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_FATAL_ONCE (   ...)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_ONCE_BEFORE
Definition: logging_macros.h:114
#define RCUTILS_LOG_CONDITION_ONCE_AFTER
Definition: logging_macros.h:123
The fatal log level.
Definition: logging.h:66

Log a message with severity FATAL with the following conditions: All subsequent log calls except the first one are being ignored.

Parameters
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_FATAL_ONCE_NAMED (   name,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_ONCE_BEFORE
Definition: logging_macros.h:114
#define RCUTILS_LOG_CONDITION_ONCE_AFTER
Definition: logging_macros.h:123
The fatal log level.
Definition: logging.h:66

Log a message with severity FATAL with the following conditions: All subsequent log calls except the first one are being ignored.

Parameters
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_FATAL_EXPRESSION (   expression,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_EXPRESSION_BEFORE(expression)
Definition: logging_macros.h:135
#define RCUTILS_LOG_CONDITION_EXPRESSION_AFTER
Definition: logging_macros.h:141
The fatal log level.
Definition: logging.h:66

Log a message with severity FATAL with the following conditions: Log calls are being ignored when the expression evaluates to false.

Parameters
expressionThe expression determining if the message should be logged
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_FATAL_EXPRESSION_NAMED (   expression,
  name,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_EXPRESSION_BEFORE(expression)
Definition: logging_macros.h:135
#define RCUTILS_LOG_CONDITION_EXPRESSION_AFTER
Definition: logging_macros.h:141
The fatal log level.
Definition: logging.h:66

Log a message with severity FATAL with the following conditions: Log calls are being ignored when the expression evaluates to false. All subsequent log calls except the first one are being ignored.

Parameters
expressionThe expression determining if the message should be logged
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_FATAL_FUNCTION (   function,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_FUNCTION_AFTER
Definition: logging_macros.h:163
#define RCUTILS_LOG_CONDITION_FUNCTION_BEFORE(function)
Definition: logging_macros.h:157
The fatal log level.
Definition: logging.h:66

Log a message with severity FATAL with the following conditions: Log calls are being ignored when the function returns false.

Parameters
functionThe functions return value determines if the message should be logged
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_FATAL_FUNCTION_NAMED (   function,
  name,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_FUNCTION_AFTER
Definition: logging_macros.h:163
#define RCUTILS_LOG_CONDITION_FUNCTION_BEFORE(function)
Definition: logging_macros.h:157
The fatal log level.
Definition: logging.h:66

Log a message with severity FATAL with the following conditions: Log calls are being ignored when the function returns false. All subsequent log calls except the first one are being ignored.

Parameters
functionThe functions return value determines if the message should be logged
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_FATAL_SKIPFIRST (   ...)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_SKIPFIRST_BEFORE
Definition: logging_macros.h:174
#define RCUTILS_LOG_CONDITION_SKIPFIRST_AFTER
Definition: logging_macros.h:184
The fatal log level.
Definition: logging.h:66

Log a message with severity FATAL with the following conditions: The first log call is being ignored but all subsequent calls are being processed.

Parameters
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_FATAL_SKIPFIRST_NAMED (   name,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_SKIPFIRST_BEFORE
Definition: logging_macros.h:174
#define RCUTILS_LOG_CONDITION_SKIPFIRST_AFTER
Definition: logging_macros.h:184
The fatal log level.
Definition: logging.h:66

Log a message with severity FATAL with the following conditions: The first log call is being ignored but all subsequent calls are being processed.

Parameters
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_FATAL_THROTTLE (   time_source_type,
  duration,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_CONDITION_THROTTLE_BEFORE(time_source_type, duration)
Definition: logging_macros.h:196
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_THROTTLE_AFTER
Definition: logging_macros.h:217
The fatal log level.
Definition: logging.h:66

Log a message with severity FATAL with the following conditions: Log calls are being ignored if the last logged message is not longer ago than the specified duration.

Parameters
time_source_typeThe time source type of the time to be used
durationThe duration of the throttle interval
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_FATAL_SKIPFIRST_THROTTLE (   time_source_type,
  duration,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_CONDITION_THROTTLE_BEFORE(time_source_type, duration)
Definition: logging_macros.h:196
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_THROTTLE_AFTER
Definition: logging_macros.h:217
#define RCUTILS_LOG_CONDITION_SKIPFIRST_BEFORE
Definition: logging_macros.h:174
#define RCUTILS_LOG_CONDITION_SKIPFIRST_AFTER
Definition: logging_macros.h:184
The fatal log level.
Definition: logging.h:66

Log a message with severity FATAL with the following conditions: The first log call is being ignored but all subsequent calls are being processed. Log calls are being ignored if the last logged message is not longer ago than the specified duration.

Parameters
time_source_typeThe time source type of the time to be used
durationThe duration of the throttle interval
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_FATAL_THROTTLE_NAMED (   time_source_type,
  duration,
  name,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_CONDITION_THROTTLE_BEFORE(time_source_type, duration)
Definition: logging_macros.h:196
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_THROTTLE_AFTER
Definition: logging_macros.h:217
The fatal log level.
Definition: logging.h:66

Log a message with severity FATAL with the following conditions: Log calls are being ignored if the last logged message is not longer ago than the specified duration.

Parameters
time_source_typeThe time source type of the time to be used
durationThe duration of the throttle interval
nameThe name of the logger
...The format string, followed by the variable arguments for the format string
#define RCUTILS_LOG_FATAL_SKIPFIRST_THROTTLE_NAMED (   time_source_type,
  duration,
  name,
  ... 
)
Value:
__VA_ARGS__)
#define RCUTILS_LOG_CONDITION_THROTTLE_BEFORE(time_source_type, duration)
Definition: logging_macros.h:196
#define RCUTILS_LOG_COND_NAMED(severity, condition_before, condition_after, name,...)
Definition: logging_macros.h:86
#define RCUTILS_LOG_CONDITION_THROTTLE_AFTER
Definition: logging_macros.h:217
#define RCUTILS_LOG_CONDITION_SKIPFIRST_BEFORE
Definition: logging_macros.h:174
#define RCUTILS_LOG_CONDITION_SKIPFIRST_AFTER
Definition: logging_macros.h:184
The fatal log level.
Definition: logging.h:66

Log a message with severity FATAL with the following conditions: The first log call is being ignored but all subsequent calls are being processed. Log calls are being ignored if the last logged message is not longer ago than the specified duration.

Parameters
time_source_typeThe time source type of the time to be used
durationThe duration of the throttle interval
nameThe name of the logger
...The format string, followed by the variable arguments for the format string

Typedef Documentation

typedef bool(* RclLogFilter) ()

The filter function signature.

Returns
true to log the message, false to ignore the message