qh_vlog_ex()

Updated: April 19, 2023

Log a formatted message using a variable-argument list

Synopsis:

#include <qh/log.h>
int int qh_vlog_ex(const qh_log_info_t *log_info,
                   const char *fmt,
                   va_list arglist)

Arguments:

log_info
The log information structure to use with this log message, or NULL to use default values.
fmt
A string that specifies the format of the output. The formatting string determines the additional arguments you need to provide. For more information, see vprintf().
arglist
A variable-argument list of the additional arguments, which must be initialized with the va_start() macro.

Library:

qh

Description:

This function logs a formatted message to the set of active destinations. It includes the severity level set in the log information structure (log_info).

This function is a varargs version of qh_log_ex().

In most cases, logging calls are done using the QNX helpers logging macros (which in turn call qh_log_ex()) because they greatly simplify the calls, but you can also use this function directly.

Although QNX does not recommend it, if it's absolutely necessary, it is safe to call this function with log_info set to NULL, which specifies the default log information and context configuration.

Returns:

EOK on success or a standard errno on failure. errno is unmodified.