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
|
/**************************************************************************
* *
* Regina - A Normal Surface Theory Calculator *
* Computational Engine *
* *
* Copyright (c) 1999-2025, Ben Burton *
* For further details contact Ben Burton (bab@debian.org). *
* *
* This program is free software; you can redistribute it and/or *
* modify it under the terms of the GNU General Public License as *
* published by the Free Software Foundation; either version 2 of the *
* License, or (at your option) any later version. *
* *
* As an exception, when this program is distributed through (i) the *
* App Store by Apple Inc.; (ii) the Mac App Store by Apple Inc.; or *
* (iii) Google Play by Google Inc., then that store may impose any *
* digital rights management, device limits and/or redistribution *
* restrictions that are required by its terms of service. *
* *
* This program is distributed in the hope that it will be useful, but *
* WITHOUT ANY WARRANTY; without even the implied warranty of *
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU *
* General Public License for more details. *
* *
* You should have received a copy of the GNU General Public License *
* along with this program. If not, see <https://www.gnu.org/licenses/>. *
* *
**************************************************************************/
/*! \file algebra/xmlalgebrareader.h
* \brief Deals with parsing XML data for various algebraic structures.
*/
#ifndef __REGINA_XMLALGEBRAREADER_H
#ifndef __DOXYGEN
#define __REGINA_XMLALGEBRAREADER_H
#endif
#include <optional>
#include "regina-core.h"
#include "algebra/abeliangroup.h"
#include "algebra/grouppresentation.h"
#include "file/xml/xmlelementreader.h"
namespace regina {
/**
* An XML element reader that reads a single abelian group.
* An abelian group is generally contained within an
* `<abeliangroup>` ... `</abeliangroup>` pair.
*
* \nopython
*/
class XMLAbelianGroupReader : public XMLElementReader {
private:
std::optional<AbelianGroup> group_;
/**< The abelian group currently being read. */
public:
/**
* Creates a new abelian group reader.
*/
XMLAbelianGroupReader() = default;
/**
* Returns a reference to the abelian group that has been read by
* this element reader.
*
* \return the group that has been read, or \nullopt if an error
* occurred.
*/
std::optional<AbelianGroup>& group();
void startElement(const std::string& tagName,
const regina::xml::XMLPropertyDict& tagProps,
XMLElementReader* parentReader) override;
void initialChars(const std::string& chars) override;
};
/**
* An XML element reader that reads a single group presentation.
* A group presentation is generally contained within a
* `<group>` ... `</group>` pair.
*
* \nopython
*/
class XMLGroupPresentationReader : public XMLElementReader {
private:
std::optional<GroupPresentation> group_;
/**< The group presentation currently being read. */
public:
/**
* Creates a new group presentation reader.
*/
XMLGroupPresentationReader() = default;
/**
* Returns a reference to the group presentation that has been read by
* this element reader.
*
* \return the group that has been read, or \nullopt if an error
* occurred.
*/
std::optional<GroupPresentation>& group();
void startElement(const std::string& tagName,
const regina::xml::XMLPropertyDict& tagProps,
XMLElementReader* parentReader) override;
XMLElementReader* startSubElement(const std::string& subTagName,
const regina::xml::XMLPropertyDict& subTagProps) override;
void endSubElement(const std::string& subTagName,
XMLElementReader* subReader) override;
};
// Inline functions for XMLAbelianGroupReader
inline std::optional<AbelianGroup>& XMLAbelianGroupReader::group() {
return group_;
}
// Inline functions for XMLGroupPresentationReader
inline std::optional<GroupPresentation>& XMLGroupPresentationReader::group() {
return group_;
}
} // namespace regina
#endif
|
