Function rcutils_logging_get_logger_effective_level

Function Documentation

int rcutils_logging_get_logger_effective_level(const char *name)

Determine the effective level for a logger.

The effective level is determined as the severity level of the logger if it is set, otherwise it is the first specified severity level of the logger’s ancestors, starting with its closest ancestor. The ancestor hierarchy is signified by logger names being separated by dots: a logger named x is an ancestor of x.y, and both x and x.y are ancestors of x.y.z, etc. If the level has not been set for the logger nor any of its ancestors, the default level is used.

Attribute

Adherence

Allocates Memory

No, provided logging system is already initialized

Thread-Safe

No

Uses Atomics

No

Lock-Free

Yes

Parameters:

name[in] The name of the logger, must be null terminated c string.

Returns:

The level, or

Returns:

-1 on invalid arguments, or

Returns:

-1 if an error occurred.