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
|
/******************************************************************************
*
* Copyright (C) 1997-2020 by Dimitri van Heesch.
*
* Permission to use, copy, modify, and distribute this software and its
* documentation under the terms of the GNU General Public License is hereby
* granted. No representations are made about the suitability of this software
* for any purpose. It is provided "as is" without express or implied warranty.
* See the GNU General Public License for more details.
*
* Documents produced by Doxygen are derivative works derived from the
* input used in their production; they are not affected by this license.
*
*/
#ifndef SECTION_H
#define SECTION_H
#include <string>
#include <unordered_map>
#include "qcstring.h"
#include "linkedmap.h"
class Definition;
//! enum representing the various types of sections and entities that can be referred to.
enum class SectionType
{
Page = 0,
Section = 1,
Subsection = 2,
Subsubsection = 3,
Paragraph = 4,
Anchor = 5,
Table = 6
};
//! return true if type is a section, and false if it is a page, anchor or table.
inline constexpr bool isSection(SectionType type)
{
return (type==SectionType::Section ||
type==SectionType::Subsection ||
type==SectionType::Subsubsection ||
type==SectionType::Paragraph);
}
//! class that provide information about a section.
class SectionInfo
{
public:
SectionInfo(const QCString &label, const QCString &fileName, int lineNr,
const QCString &title, SectionType type, int level,const QCString &ref) :
m_label(label), m_title(title), m_type(type), m_ref(ref),
m_lineNr(lineNr), m_fileName(fileName), m_level(level)
{
//printf("SectionInfo(%p)\n",this);
}
~SectionInfo()
{
//printf("~SectionInfo(%p)\n",this);
}
// getters
QCString label() const { return m_label; }
QCString title() const { return m_title; }
SectionType type() const { return m_type; }
QCString ref() const { return m_ref; }
int lineNr() const { return m_lineNr; }
QCString fileName() const { return m_fileName; }
bool generated() const { return m_generated; }
int level() const { return m_level; }
Definition *definition() const { return m_definition; }
// setters
void setFileName(const QCString &fn) { m_fileName = fn; }
void setType(SectionType t) { m_type = t; }
void setGenerated(bool b) { m_generated = b; }
void setDefinition(Definition *d) { m_definition = d; }
private:
QCString m_label;
QCString m_title;
SectionType m_type;
QCString m_ref;
int m_lineNr;
QCString m_fileName;
bool m_generated = false;
int m_level;
Definition *m_definition = 0;
};
//! class that represents a list of constant references to sections.
class SectionRefs
{
using SectionInfoVec = std::vector<const SectionInfo*>;
public:
using const_iterator = SectionInfoVec::const_iterator;
//! Returns a constant pointer to the section info given a section label or nullptr
//! if no section with the given label can be found.
const SectionInfo *find(const QCString &label) const
{
auto it = m_lookup.find(label.str());
return it!=m_lookup.end() ? it->second : nullptr;
}
//! Adds a non-owning section reference.
void add(const SectionInfo *si)
{
m_lookup.insert({toStdString(si->label()),si});
m_entries.push_back(si);
}
const_iterator begin() const { return m_entries.cbegin(); }
const_iterator end() const { return m_entries.cend(); }
bool empty() const { return m_entries.empty(); }
size_t size() const { return m_entries.size(); }
private:
SectionInfoVec m_entries;
std::unordered_map< std::string, const SectionInfo* > m_lookup;
};
//! singleton class that owns the list of all sections
class SectionManager : public LinkedMap<SectionInfo>
{
public:
//! Add a new section given the data of an existing section.
//! Returns a non-owning pointer to the newly added section.
SectionInfo *add(const SectionInfo &si)
{
return LinkedMap<SectionInfo>::add(si.label(),si.fileName(),
si.lineNr(),si.title(),si.type(),si.level(),si.ref());
}
//! Add a new section
//! Return a non-owning pointer to the newly added section
SectionInfo *add(const QCString &label, const QCString &fileName, int lineNr,
const QCString &title, SectionType type, int level,const QCString &ref=QCString())
{
return LinkedMap<SectionInfo>::add(label.data(),fileName,lineNr,title,type,level,ref);
}
//! returns a reference to the singleton
static SectionManager &instance()
{
static SectionManager sm;
return sm;
}
private:
SectionManager() {}
SectionManager(const SectionManager &other) = delete;
SectionManager &operator=(const SectionManager &other) = delete;
};
#endif
|
