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
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
| //===-- Declaration.h -------------------------------------------*- C++ -*-===//
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//
#ifndef liblldb_Declaration_h_
#define liblldb_Declaration_h_
#include "lldb/Utility/FileSpec.h"
#include "lldb/lldb-private.h"
namespace lldb_private {
/// \class Declaration Declaration.h "lldb/Symbol/Declaration.h"
/// A class that describes the declaration location of a
/// lldb object.
///
/// The declarations include the file specification, line number, and the
/// column info and can help track where functions, blocks, inlined functions,
/// types, variables, any many other debug core objects were declared.
class Declaration {
public:
/// Default constructor.
Declaration()
: m_file(), m_line(0)
#ifdef LLDB_ENABLE_DECLARATION_COLUMNS
,
m_column(0)
#endif
{
}
/// Construct with file specification, and optional line and column.
///
/// \param[in] file_spec
/// The file specification that describes where this was
/// declared.
///
/// \param[in] line
/// The line number that describes where this was declared. Set
/// to zero if there is no line number information.
///
/// \param[in] column
/// The column number that describes where this was declared.
/// Set to zero if there is no column number information.
Declaration(const FileSpec &file_spec, uint32_t line = 0, uint32_t column = 0)
: m_file(file_spec), m_line(line)
#ifdef LLDB_ENABLE_DECLARATION_COLUMNS
,
m_column(column)
#endif
{
}
/// Construct with a reference to another Declaration object.
Declaration(const Declaration &rhs)
: m_file(rhs.m_file), m_line(rhs.m_line)
#ifdef LLDB_ENABLE_DECLARATION_COLUMNS
,
m_column(rhs.m_column)
#endif
{
}
/// Construct with a pointer to another Declaration object.
Declaration(const Declaration *decl_ptr)
: m_file(), m_line(0)
#ifdef LLDB_ENABLE_DECLARATION_COLUMNS
,
m_column(0)
#endif
{
if (decl_ptr)
*this = *decl_ptr;
}
/// Clear the object's state.
///
/// Sets the file specification to be empty, and the line and column to
/// zero.
void Clear() {
m_file.Clear();
m_line = 0;
#ifdef LLDB_ENABLE_DECLARATION_COLUMNS
m_column = 0;
#endif
}
/// Compare two declaration objects.
///
/// Compares the two file specifications from \a lhs and \a rhs. If the file
/// specifications are equal, then continue to compare the line number and
/// column numbers respectively.
///
/// \param[in] lhs
/// The Left Hand Side const Declaration object reference.
///
/// \param[in] rhs
/// The Right Hand Side const Declaration object reference.
///
/// \return
/// \li -1 if lhs < rhs
/// \li 0 if lhs == rhs
/// \li 1 if lhs > rhs
static int Compare(const Declaration &lhs, const Declaration &rhs);
/// Checks if this object has the same file and line as another declaration
/// object.
///
/// \param[in] declaration
/// The const Declaration object to compare with.
///
/// \return
/// Returns \b true if \b declaration is at the same file and
/// line, \b false otherwise.
bool FileAndLineEqual(const Declaration &declaration) const;
/// Dump a description of this object to a Stream.
///
/// Dump a description of the contents of this object to the supplied stream
/// \a s.
///
/// \param[in] s
/// The stream to which to dump the object description.
void Dump(Stream *s, bool show_fullpaths) const;
bool DumpStopContext(Stream *s, bool show_fullpaths) const;
/// Get accessor for the declaration column number.
///
/// \return
/// Non-zero indicates a valid column number, zero indicates no
/// column information is available.
uint32_t GetColumn() const {
#ifdef LLDB_ENABLE_DECLARATION_COLUMNS
return m_column;
#else
return 0;
#endif
}
/// Get accessor for file specification.
///
/// \return
/// A reference to the file specification object.
FileSpec &GetFile() { return m_file; }
/// Get const accessor for file specification.
///
/// \return
/// A const reference to the file specification object.
const FileSpec &GetFile() const { return m_file; }
/// Get accessor for the declaration line number.
///
/// \return
/// Non-zero indicates a valid line number, zero indicates no
/// line information is available.
uint32_t GetLine() const { return m_line; }
bool IsValid() const { return m_file && m_line != 0; }
/// Get the memory cost of this object.
///
/// \return
/// The number of bytes that this object occupies in memory.
/// The returned value does not include the bytes for any
/// shared string values.
///
/// \see ConstString::StaticMemorySize ()
size_t MemorySize() const;
/// Set accessor for the declaration column number.
///
/// \param[in] column
/// Non-zero indicates a valid column number, zero indicates no
/// column information is available.
void SetColumn(uint32_t column) {
#ifdef LLDB_ENABLE_DECLARATION_COLUMNS
m_column = col;
#endif
}
/// Set accessor for the declaration file specification.
///
/// \param[in] file_spec
/// The new declaration file specification.
void SetFile(const FileSpec &file_spec) { m_file = file_spec; }
/// Set accessor for the declaration line number.
///
/// \param[in] line
/// Non-zero indicates a valid line number, zero indicates no
/// line information is available.
void SetLine(uint32_t line) { m_line = line; }
protected:
/// Member variables.
FileSpec m_file; ///< The file specification that points to the
///< source file where the declaration occurred.
uint32_t m_line; ///< Non-zero values indicates a valid line number,
///< zero indicates no line number information is available.
#ifdef LLDB_ENABLE_DECLARATION_COLUMNS
uint32_t m_column; ///< Non-zero values indicates a valid column number,
///< zero indicates no column information is available.
#endif
};
bool operator==(const Declaration &lhs, const Declaration &rhs);
} // namespace lldb_private
#endif // liblldb_Declaration_h_
|