SNIP_ADAPTIVE_CAN_FIGURE_Figure_16_1

Figure 16.1: Overview Log and Trace The ara::log Functional Cluster defines a "Builder"-pattern inspired set of APIs for constructing non-modeled messages and a single member function ara::log::Logger::Log for sending modeled messages. Unlike the non-modeled message APIs, it represents a single-call interface, i.e. a single function call passes all arguments to the Logger instance and performs all necessary actions to generate and send the message. This has the advantage that the runtime cost for a modeled message that is eventually not being output (because the messages log level does not reach the configured log level threshold) can be made very small: after parameter passing and function call, a single if clause checks the log level threshold and immediately returns if the threshold is not reached. This contrasts with the non-modeled message APIs, where multiple function calls are performed for constructing a message object, even if that is then eventually discarded.