Main functions

Primary C++ functions for outputting trace messages. More...

Functions
int	micro_os_plus::trace::printf (const char *format,...) noexcept
	Write a formatted string to the trace output channel.
int	micro_os_plus::trace::putchar (int c) noexcept
	Write the single character to the trace output channel.
int	micro_os_plus::trace::puts (const char *s="") noexcept
	Write the string and a line terminator to the trace output channel.
int	micro_os_plus::trace::vprintf (const char *format, std::va_list arguments) noexcept
	Write a formatted variable arguments list to the trace output channel.

Detailed Description

These functions serve as the primary methods for outputting trace messages in C++ projects.

Function Documentation

printf()

int micro_os_plus::trace::printf ( const char * format, ... )

inlinenoexcept

Parameters

format	A null terminated string with the format.
...	Additional arguments matching the format specifiers.

Returns

The number of bytes written, or -1 if an error occurred.

Thin wrapper over tracer<T>::printf(). Subject to the same fixed-size stack buffer constraint and truncation behaviour.

Definition at line 235 of file trace-cpp-api-inlines.h.

  {
    std::va_list arguments;
    va_start (arguments, format);
#pragma GCC diagnostic push
#if defined(__clang__)
#pragma clang diagnostic ignored "-Wunsafe-buffer-usage-in-libc-call"
#endif
    int ret
        = detail::tracer<detail::implementation>::vprintf (format, arguments);
#pragma GCC diagnostic pop
    va_end (arguments);
    return ret;
  }

References micro_os_plus::trace::detail::tracer< T >::vprintf().

Referenced by micro_os_plus::trace::detail::tracer< T >::dump_args().

putchar()

int micro_os_plus::trace::putchar ( int c )

inlinenoexcept

Parameters

c	A single byte character, passed as an int.

Returns

The written character as an int, or EOF (-1) if an error occurred.

Thin wrapper over tracer<T>::putchar().

Definition at line 273 of file trace-cpp-api-inlines.h.

  {
    return detail::tracer<detail::implementation>::putchar (c);
  }

References micro_os_plus::trace::detail::tracer< T >::putchar().

puts()

int micro_os_plus::trace::puts ( const char * s = "" )

inlinenoexcept

Parameters

s	A null terminated string (default: empty string).

Returns

The total number of bytes written (string + newline), or EOF (-1) if an error occurred.

Thin wrapper over tracer<T>::puts().

Definition at line 262 of file trace-cpp-api-inlines.h.

  {
#pragma GCC diagnostic push
#if defined(__clang__)
#pragma clang diagnostic ignored "-Wunsafe-buffer-usage-in-libc-call"
#endif
    return detail::tracer<detail::implementation>::puts (s);
#pragma GCC diagnostic pop
  }

References micro_os_plus::trace::detail::tracer< T >::puts().

vprintf()

int micro_os_plus::trace::vprintf ( const char * format, std::va_list arguments )

inlinenoexcept

Parameters

format	A null terminated string with the format.
arguments	A variable arguments list.

Returns

The number of bytes written, or -1 if an error occurred.

Thin wrapper over tracer<T>::vprintf().

Definition at line 251 of file trace-cpp-api-inlines.h.

  {
#pragma GCC diagnostic push
#if defined(__clang__)
#pragma clang diagnostic ignored "-Wunsafe-buffer-usage-in-libc-call"
#endif
    return detail::tracer<detail::implementation>::vprintf (format, arguments);
#pragma GCC diagnostic pop
  }

References micro_os_plus::trace::detail::tracer< T >::vprintf().

Referenced by micro_os_plus::trace::detail::tracer< T >::printf().