Class unit_test_log_t . Boost , Boost.Test , Header <boost/test/unit_test_log.hpp>

Class unit_test_log_t

boost::unit_test::unit_test_log_t — Manages the sets of loggers, their streams and log levels.

Synopsis

// In header: <boost/test/unit_test_log.hpp>

class unit_test_log_t :
  public boost::unit_test::test_observer, public singleton< unit_test_log_t >
{
public:
  // public member functions
  virtual void test_start(counter_t);
  virtual void test_finish();
  virtual void test_aborted();
  virtual void test_unit_start(test_unit const &);
  virtual void test_unit_finish(test_unit const &, unsigned long);
  virtual void test_unit_skipped(test_unit const &, const_string);
  virtual void test_unit_aborted(test_unit const &);
  virtual void exception_caught(execution_exception const &);
  virtual int priority();
  void set_stream(std::ostream &);
  void set_stream(output_format, std::ostream &);
  void set_threshold_level(log_level);
  void set_threshold_level(output_format, log_level);
  void add_format(output_format);
  void set_format(output_format);
  unit_test_log_formatter * get_formatter(output_format);
  void set_formatter(unit_test_log_formatter *);
  void add_formatter(unit_test_log_formatter *);
  void set_checkpoint(const_string, std::size_t, 
                      const_string = const_string());
  unit_test_log_t & operator<<(log::begin const &);
  unit_test_log_t & operator<<(log::end const &);
  unit_test_log_t & operator<<(log_level);
  unit_test_log_t & operator<<(const_string);
  unit_test_log_t & operator<<(lazy_ostream const &);
  unspecified operator()(log_level);
  virtual void test_unit_skipped(test_unit const &);
  virtual void assertion_result(unit_test::assertion_result);
  // private member functions
  bool log_entry_start(output_format);
  void log_entry_context(log_level);
  void clear_entry_context();
  // protected member functions
  virtual void assertion_result(bool);
};

Description

Начало. Тестовый фреймворк позволяет одновременно иметь несколько форматировщиков/логгеров, каждый из которых имеет свой собственный уровень журнала и выходной поток.

Этот класс служит цели

экспонирование интерфейса в тестовую структуру (в качестве повышения::unit_test::test_observer))
Обнаружение интерфейса с инструментами тестирования
Управление несколькими лесозаготовителями

	Note
	Доступ к функциям этого класса осуществляется через синглтон<`boost::unit_test::unit_test_log`>.

Пользователи / разработчики, желающие реализовать свой собственный форматтер, должны:

реализовать усилитель::unit_test:::unit_test_log_formatter, который выведет желаемый формат
регистрируют форматировщик во время, например, глобальной фиксации с использованием метода<set_formatter>(хотя фреймворк синглтон).

Warning

Этот наблюдатель имеет более высокий приоритет, чем усилитель::unit_test::results_collector_t. Это означает, что различныеимпульсы::unit_test::test_results, связанные с каждым испытательным блоком, могут быть недоступны в момент вызова<test_unit_start>,<test_unit_finish>.

Смотрите также:

`unit_test_log_t` public member functions

```
virtualvoidtest_start(counter_t);
```
Называется до того, как фреймворк начнет выполнять тестовые случаи.
<
```
virtualvoidtest_finish();
```
>Называется после того, как фреймворк завершает выполнение тестовых случаев.
Примечание
Звонок производится с обратным приоритетным заказом.
<
```
virtualvoidtest_aborted();
```
>При обнаружении критической ошибки.
Критические ошибки — это в основном сигналы, посылаемые системой и пойманные Boost. Рамки испытаний. Поскольку исполняемая двоичная система может находиться в некогерентном/нестабильном состоянии, выполнение теста прерывается и все оставшиеся тесты отбрасываются.
Примечание
может быть вызвано перед test_observer::test_unit_finish()
<
```
virtualvoidtest_unit_start(test_unitconst&);
```
>Называется до того, как фреймворк начинает выполнять тестовый блок.
```
virtualvoidtest_unit_finish(test_unitconst&,unsignedlonglong);
```
Называется на каждом конце испытательного блока.

virtualvoidtest_unit_skipped(test_unitconst&,const_string);

```
virtualvoidtest_unit_aborted(test_unitconst&);
```
Называется, когда испытательный блок указывает на фатальную ошибку.
Смертельная ошибка происходит, когда
- сильное утверждение (сREQUIRE) не удается, что указывает на то, что тестовый случай не может продолжаться.
- Неожиданное исключение поймано Ростом. Система испытаний
```
virtualvoidexception_caught(execution_exceptionconst&);
```
Называется, когда перехвачено исключение.
В случае перехвата исключения этот вызов происходит до вызова test_unit_aborted для регистрации дополнительных данных об исключении.
<
```
virtualintpriority();
```
>
<
```
voidset_stream(std::ostream&);
```
>Устанавливает поток для всех лесорубов.
Это отменяет бревенчатую раковину/поток всех лесозаготовителей, независимо от того, включены они или нет.
```
voidset_stream(output_format,std::ostream&);
```
Устанавливает поток для конкретного лесозаготовителя.
Примечание
Не имеет эффекта, если указанный формат не найден
С момента подъема 1.62.
<
```
voidset_threshold_level(log_level);
```
>Устанавливает пороговый уровень для всех регистраторов/форматеров.
Это отменяет уровень журнала всех лесозаготовителей, независимо от того, включены они или нет.
<
```
voidset_threshold_level(output_format,log_level);
```
>Устанавливает пороговый/логовый уровень конкретного формата.
Примечание
Не имеет эффекта, если указанный формат не найден
С момента подъема 1.62.
<
```
voidadd_format(output_format);
```
>Добавить формат в набор регистраторов.
Добавление регистратора означает, что указанный регистратор включен. Уровень журнала управляется самим форматировщиком и определяет, какие события передаются на базовый форматировщик.
С момента подъема 1.62.
```
voidset_format(output_format);
```
Устанавливает формат лесозаготовителя.
Это станет единственным активным форматом журналов.
```
unit_test_log_formatter*get_formatter(output_format);
```
Возвращает регистратор для конкретного формата.
Так как Boost 1.62 .
Возвращается:
экземпляр регистратора/формата или(unit_test_log_formatter*)0, если формат не найден.

voidset_formatter(unit_test_log_formatter*);

Устанавливает регистратор.

Указанный лесоруб становится единственным действующим. Формат журнала имеет форматOF_CUSTOM_LOGGER. Если такой формат уже существует, его формататор заменяется тем, который приведен в аргументе.

Уровень журнала и выходной поток нового форматтера взяты из текущего активного регистратора. Если активны несколько регистраторов, порядок приоритета - CUSTOM, HRF, XML и JUNIT. Если (unit_test_log_formatter*)0 приведен в качестве аргумента, пользовательский регистратор (если таковой имеется) удаляется.

Примечание

Право собственности на указатель переходит к Boost. Рамки испытаний. Этот призыв эквивалентен

призыву кadd_formatter
.
призыв к<set_format(OF_CUSTOM_LOGGER)>
конфигурация вновь добавленного регистратора с ранее сконфигурированным потоком и уровнем журнала.

```
voidadd_formatter(unit_test_log_formatter*the_formatter);
```
Добавляет пользовательский форматировщик журналов в набор форматировщиков.
Указанный регистратор добавляется с форматомOF_CUSTOM_LOGGER, так что он может быть дополнительно выбран или может быть указан его уровень потока/лога. Если же у вас уже есть логгер (сOF_CUSTOM_LOGGER), то существующий заменяется тем, который приведен в аргументе. Предоставляемый регистратор добавляется с включенным состоянием. Если (unit_test_log_formatter*)0 приведен в качестве аргумента, пользовательский регистратор (если таковой имеется) удаляется и никакие другие действия не выполняются.
Примечание
Право собственности на указатель переходит к Boost. Рамки испытаний.
С момента подъема 1.62.

voidset_checkpoint(const_stringfile,std::size_tline_num,
                   const_stringmsg=const_string());

unit_test_log_t&operator<<(log::beginconst&);

unit_test_log_t&operator<<(log::endconst&);

<
```
unit_test_log_t&operator<<(log_level);
```
>

unit_test_log_t&operator<<(const_string);

unit_test_log_t&operator<<(lazy_ostreamconst&);

<
```
unspecifiedoperator()(log_level);
```
>

virtualvoidtest_unit_skipped(test_unitconst&);

обратная совместимость

virtualvoidassertion_result(unit_test::assertion_resultar);

`unit_test_log_t` private member functions

boollog_entry_start(output_formatlog_format);

<
```
voidlog_entry_context(log_levell);
```
>
<
```
voidclear_entry_context();
```
>

`unit_test_log_t` protected member functions

```
virtualvoidassertion_result(bool);
```
Унизительно.

Статья Class unit_test_log_t раздела Boost.Test Header <boost/test/unit_test_log.hpp> может быть полезна для разработчиков на c++ и boost.

Class unit_test_log_t

Boost , Boost.Test , Header <boost/test/unit_test_log.hpp>

Boost C++ Libraries

Class unit_test_log_t

Synopsis

Description

unit_test_log_t public member functions

unit_test_log_t private member functions

unit_test_log_t protected member functions

`unit_test_log_t` public member functions

`unit_test_log_t` private member functions

`unit_test_log_t` protected member functions