blob: b6b5429cc8aa4465c6347ad04d5aa42d97c3cdac (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
|
// -*- C++ -*-
//=============================================================================
/**
* @file Trace.h
*
* $Id$
*
* @author Douglas C. Schmidt <schmidt@cs.wustl.edu>
*/
//=============================================================================
#ifndef ACE_TRACE_H
#define ACE_TRACE_H
#include "ace/pre.h"
#include "ace/ACE_export.h"
#if !defined (ACE_LACKS_PRAGMA_ONCE)
# pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */
#include "ace/Global_Macros.h"
/**
* @class ACE_Trace
*
* @brief A C++ trace facility that keeps track of which methods are
* entered and exited.
*
* This class uses C++ constructors and destructors to automate
* the ACE_Trace nesting. In addition, thread-specific storage
* is used to enable multiple threads to work correctly.
*/
class ACE_Export ACE_Trace
{
public:
// = Initialization and termination methods.
/// Perform the first part of the trace, which prints out the string
/// N, the LINE, and the ACE_FILE as the function is entered.
ACE_Trace (const ACE_TCHAR *n,
int line = 0,
const ACE_TCHAR *file = ACE_LIB_TEXT (""));
/// Perform the second part of the trace, which prints out the NAME
/// as the function is exited.
~ACE_Trace (void);
// = Control the tracing level.
/// Determine if tracing is enabled (return == 1) or not (== 0)
static int is_tracing(void);
/// Enable the tracing facility.
static void start_tracing (void);
/// Disable the tracing facility.
static void stop_tracing (void);
/// Change the nesting indentation level.
static void set_nesting_indent (int indent);
/// Get the nesting indentation level.
static int get_nesting_indent (void);
/// Dump the state of an object.
void dump (void) const;
private:
// Keeps track of how deeply the call stack is nested (this is
// maintained in thread-specific storage to ensure correctness in
// multiple threads of control.
/// Name of the method we are in.
const ACE_TCHAR *name_;
/// Keeps track of how far to indent per trace call.
static int nesting_indent_;
/// Is tracing enabled?
static int enable_tracing_;
/// Default values.
enum
{
DEFAULT_INDENT = 3,
DEFAULT_TRACING = 1
};
};
#include "ace/post.h"
#endif /* ACE_TRACE_H */
|
