rtems/rtems-docs
1
0
Fork 0
mirror of https://git.rtems.org/rtems-docs/ synced 2025-10-18 08:21:31 +08:00
Code Issues Packages Projects Releases Wiki Activity

eng: Document test framework formatted output

Browse Source 
Update #3199.
This commit is contained in:
Sebastian Huber
2020-02-09 11:09:22 +01:00
parent a4b23d9ba8
commit 45a0f65798
1 changed files with 23 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

30
eng/test-framework.rst
View File

@@ -982,10 +982,10 @@ fails.
P:0:0:UI1:test-psx.c:13
E:stat:N:1:F:0
Custom Log Messages
-------------------
Log Messages and Formatted Output
---------------------------------
You can print custom log messages with the `T_log()` function:
You can print log messages with the `T_log()` function:
.. code-block:: c
@@ -994,24 +994,40 @@ You can print custom log messages with the `T_log()` function:
A newline is automatically added to terminate the log message line.
.. code-block:: c
:caption: Custom Log Message Example
:caption: Log Message Example
#include <t.h>
T_TEST_CASE(log)
{
T_log(T_NORMAL, "a custom message %i, %i, %i", 1, 2, 3);
T_log(T_NORMAL, "a log message %i, %i, %i", 1, 2, 3);
T_set_verbosity(T_QUIET);
T_log(T_NORMAL, "not verbose enough");
}
.. code-block:: none
:caption: Custom Log Message Report
:caption: Log Message Report
B:log
L:a custom message 1, 2, 3
L:a log message 1, 2, 3
E:log:N:0:F:0
You can use the following functions to print formatted output:
.. code-block:: c
int T_printf(char const *, ...);
int T_vprintf(char const *, va_list);
int T_snprintf(char *, size_t, const char *, ...);
In contrast to the corresponding standard C library functions, floating-point
and exotic formats may be not supported. On some architectures supported by
RTEMS, floating-point operations are only supported in special tasks and may be
forbidden in interrupt context. The formatted output functions provided by the
test framework work in every context.
Time Services
-------------