1/*
2 *  Copyright (c) 2013 The WebRTC project authors. All Rights Reserved.
3 *
4 *  Use of this source code is governed by a BSD-style license
5 *  that can be found in the LICENSE file in the root of the source
6 *  tree. An additional intellectual property rights grant can be found
7 *  in the file PATENTS.  All contributing project authors may
8 *  be found in the AUTHORS file in the root of the source tree.
9 */
10
11#ifndef WEBRTC_TEST_TEST_SUPPORT_TRACE_TO_STDERR_H_
12#define WEBRTC_TEST_TEST_SUPPORT_TRACE_TO_STDERR_H_
13
14#include "webrtc/system_wrappers/interface/trace.h"
15
16namespace webrtc {
17namespace test {
18
19// Upon constructing an instance of this class, all traces will be redirected
20// to stderr. At destruction, redirection is halted.
21class TraceToStderr : public TraceCallback {
22 public:
23  TraceToStderr();
24  // Set |override_time| to true to control the time printed with each trace
25  // through SetTimeSeconds(). Otherwise, the trace's usual wallclock time is
26  // used.
27  //
28  // This is useful for offline test tools, where the file time is much more
29  // informative than the real time.
30  explicit TraceToStderr(bool override_time);
31  virtual ~TraceToStderr();
32
33  // Every subsequent trace printout will use |time|. Has no effect if
34  // |override_time| in the constructor was set to false.
35  //
36  // No attempt is made to ensure thread-safety between the trace writing and
37  // time updating. In tests, since traces will normally be triggered by the
38  // main thread doing the time updating, this should be of no concern.
39  virtual void SetTimeSeconds(float time);
40
41  // Implements TraceCallback.
42  virtual void Print(TraceLevel level,
43                     const char* msg_array,
44                     int length) OVERRIDE;
45
46 private:
47  bool override_time_;
48  float time_seconds_;
49};
50
51}  // namespace test
52}  // namespace webrtc
53
54#endif  // WEBRTC_TEST_TEST_SUPPORT_TRACE_TO_STDERR_H_
55