1<html> 2<head> 3<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 4<title>log_format</title> 5<link rel="stylesheet" href="../../../boostbook.css" type="text/css"> 6<meta name="generator" content="DocBook XSL Stylesheets V1.79.1"> 7<link rel="home" href="../../../index.html" title="Boost.Test"> 8<link rel="up" href="../rt_param_reference.html" title="Runtime parameters reference"> 9<link rel="prev" href="list_labels.html" title="list_labels"> 10<link rel="next" href="log_level.html" title="log_level"> 11</head> 12<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> 13<table cellpadding="2" width="100%"><tr> 14<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td> 15<td align="center"><a href="../../../../../../../index.html">Home</a></td> 16<td align="center"><a href="../../../../../../../libs/libraries.htm">Libraries</a></td> 17<td align="center"><a href="http://www.boost.org/users/people.html">People</a></td> 18<td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td> 19<td align="center"><a href="../../../../../../../more/index.htm">More</a></td> 20</tr></table> 21<hr> 22<div class="spirit-nav"> 23<a accesskey="p" href="list_labels.html"><img src="../../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../rt_param_reference.html"><img src="../../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="log_level.html"><img src="../../../../../../../doc/src/images/next.png" alt="Next"></a> 24</div> 25<div class="section"> 26<div class="titlepage"><div><div><h4 class="title"> 27<a name="boost_test.utf_reference.rt_param_reference.log_format"></a><a class="link" href="log_format.html" title="log_format"><code class="computeroutput"><span class="identifier">log_format</span></code></a> 28</h4></div></div></div> 29<p> 30 Parameter <span class="emphasis"><em>log_format</em></span> allows to set the <span class="emphasis"><em>Unit 31 Test Framework</em></span> log format to one of the formats supplied by 32 the framework. To specify custom log format use the <a class="link" href="../../test_output/logging_api/custom_log_formatter.html#ref_log_formatter_api">custom 33 log formatting API</a>. 34 </p> 35<p> 36 The only acceptable values for this parameter are the names of the output 37 formats supplied by the framework. By default the framework uses human 38 readable format (HRF) for the testing log. This format is similar to a 39 compiler error format. Alternatively you can specify XML or JUNIT as a 40 log format which are easier to process by testing automation tools. 41 </p> 42<h5> 43<a name="boost_test.utf_reference.rt_param_reference.log_format.h0"></a> 44 <span class="phrase"><a name="boost_test.utf_reference.rt_param_reference.log_format.acceptable_values"></a></span><a class="link" href="log_format.html#boost_test.utf_reference.rt_param_reference.log_format.acceptable_values">Acceptable 45 values</a> 46 </h5> 47<p> 48 <a class="link" href="../rt_param_reference.html#enum_param_value">Enumeration</a> names: 49 </p> 50<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 51<li class="listitem"> 52 <span class="bold"><strong>HRF</strong></span> (default) 53 </li> 54<li class="listitem"> 55 XML 56 </li> 57<li class="listitem"> 58 JUNIT 59 </li> 60</ul></div> 61<h5> 62<a name="boost_test.utf_reference.rt_param_reference.log_format.h1"></a> 63 <span class="phrase"><a name="boost_test.utf_reference.rt_param_reference.log_format.command_line_syntax"></a></span><a class="link" href="log_format.html#boost_test.utf_reference.rt_param_reference.log_format.command_line_syntax">Command 64 line syntax</a> 65 </h5> 66<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 67<li class="listitem"> 68 <code class="computeroutput"><span class="special">--</span><span class="identifier">log_format</span><span class="special">=<</span><span class="identifier">format</span><span class="special">></span></code> 69 </li> 70<li class="listitem"> 71 <code class="computeroutput"><span class="special">-</span><span class="identifier">f</span> 72 <span class="special"><</span><span class="identifier">format</span><span class="special">></span></code> 73 </li> 74</ul></div> 75<h5> 76<a name="boost_test.utf_reference.rt_param_reference.log_format.h2"></a> 77 <span class="phrase"><a name="boost_test.utf_reference.rt_param_reference.log_format.environment_variable"></a></span><a class="link" href="log_format.html#boost_test.utf_reference.rt_param_reference.log_format.environment_variable">Environment 78 variable</a> 79 </h5> 80<pre class="programlisting"><span class="identifier">BOOST_TEST_LOG_FORMAT</span> 81</pre> 82</div> 83<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr> 84<td align="left"></td> 85<td align="right"><div class="copyright-footer">Copyright © 2001-2020 Boost.Test contributors<p> 86 Distributed under the Boost Software License, Version 1.0. (See accompanying 87 file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>) 88 </p> 89</div></td> 90</tr></table> 91<hr> 92<div class="spirit-nav"> 93<a accesskey="p" href="list_labels.html"><img src="../../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../rt_param_reference.html"><img src="../../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="log_level.html"><img src="../../../../../../../doc/src/images/next.png" alt="Next"></a> 94</div> 95</body> 96</html> 97
