Cockatrice 2026-06-01-Development-3.1.0-beta.3
A virtual tabletop for multiplayer card games
Loading...
Searching...
No Matches
deck_list.h
Go to the documentation of this file.
1
9
10#ifndef DECKLIST_H
11#define DECKLIST_H
12
13#include "deck_list_memento.h"
14#include "deck_list_node_tree.h"
15#include "sideboard_plan.h"
17
18#include <QMap>
19#include <QVector>
20#include <QtCore/QXmlStreamReader>
22
25class CardDatabase;
26class QIODevice;
27class QTextStream;
29
63{
64public:
65 struct Metadata
66 {
67 QString name;
68 QString comments;
69 QString gameFormat;
71 QStringList tags;
73
77 bool isEmpty() const;
78 };
79
80private:
82 QMap<QString, SideboardPlan> sideboardPlans;
84
89 mutable QString cachedDeckHash;
90
91public:
94 void setName(const QString &_name = QString())
95 {
96 metadata.name = _name;
97 }
98 void setComments(const QString &_comments = QString())
99 {
100 metadata.comments = _comments;
101 }
102 void setTags(const QStringList &_tags = QStringList())
103 {
104 metadata.tags = _tags;
105 }
106 void addTag(const QString &_tag)
107 {
108 metadata.tags.append(_tag);
109 }
111 {
112 metadata.tags.clear();
113 }
114 void setBannerCard(const CardRef &_bannerCard = {})
115 {
116 metadata.bannerCard = _bannerCard;
117 }
118 void setLastLoadedTimestamp(const QString &_lastLoadedTimestamp = QString())
119 {
120 metadata.lastLoadedTimestamp = _lastLoadedTimestamp;
121 }
122 void setGameFormat(const QString &_gameFormat = QString())
123 {
124 metadata.gameFormat = _gameFormat;
125 }
126
127
129 explicit DeckList();
131 explicit DeckList(const QString &nativeString);
133 DeckList(const Metadata &metadata,
134 const DecklistNodeTree &tree,
135 const QMap<QString, SideboardPlan> &sideboardPlans = {});
136
143 {
144 return &tree;
145 }
146
153 const Metadata &getMetadata() const
154 {
155 return metadata;
156 }
157 QString getName() const
158 {
159 return metadata.name;
160 }
161 QString getComments() const
162 {
163 return metadata.comments;
164 }
165 QStringList getTags() const
166 {
167 return metadata.tags;
168 }
170 {
171 return metadata.bannerCard;
172 }
174 {
175 return metadata.lastLoadedTimestamp;
176 }
177 QString getGameFormat() const
178 {
179 return metadata.gameFormat;
180 }
181
182
183 bool isBlankDeck() const
184 {
185 return metadata.isEmpty() && getCardList().isEmpty();
186 }
187
190 QList<MoveCard_ToZone> getCurrentSideboardPlan() const;
191 void setCurrentSideboardPlan(const QList<MoveCard_ToZone> &plan);
192 const QMap<QString, SideboardPlan> &getSideboardPlans() const
193 {
194 return sideboardPlans;
195 }
196
197
200 bool readElement(QXmlStreamReader *xml);
201 void write(QXmlStreamWriter *xml) const;
202 bool loadFromXml(QXmlStreamReader *xml);
203 bool loadFromString_Native(const QString &nativeString);
204 QString writeToString_Native() const;
205 bool loadFromFile_Native(QIODevice *device);
206 bool saveToFile_Native(QIODevice *device) const;
208
211 bool loadFromStream_Plain(QTextStream &stream,
212 bool preserveMetadata,
213 const std::function<QString(const QString &)> &cardNameNormalizer);
214 bool loadFromFile_Plain(QIODevice *device, const std::function<QString(const QString &)> &cardNameNormalizer);
215 bool saveToStream_Plain(QTextStream &stream, bool prefixSideboardCards, bool slashTappedOutSplitCards) const;
216 bool
217 saveToFile_Plain(QIODevice *device, bool prefixSideboardCards = true, bool slashTappedOutSplitCards = false) const;
218 QString writeToString_Plain(bool prefixSideboardCards = true, bool slashTappedOutSplitCards = false) const;
220
223 void cleanList(bool preserveMetadata = false);
224 bool isEmpty() const
225 {
226 return tree.isEmpty() && metadata.isEmpty() && sideboardPlans.isEmpty();
227 }
228 QStringList getCardList(const QSet<QString> &restrictToZones = {}) const;
229 QList<CardRef> getCardRefList(const QSet<QString> &restrictToZones = {}) const;
230 QList<const DecklistCardNode *> getCardNodes(const QSet<QString> &restrictToZones = {}) const;
231 QList<const InnerDecklistNode *> getZoneNodes(const QSet<QString> &restrictToZones = {}) const;
232 int getSideboardSize() const;
233
234 DecklistCardNode *addCard(const QString &cardName,
235 const QString &zoneName,
236 int position = -1,
237 const QString &cardSetName = QString(),
238 const QString &cardSetCollectorNumber = QString(),
239 const QString &cardProviderId = QString(),
240 const bool formatLegal = true);
242
245 QString getDeckHash() const;
246 void refreshDeckHash();
248
254 void forEachCard(const std::function<void(InnerDecklistNode *, DecklistCardNode *)> &func) const;
255 DeckListMemento createMemento(const QString &reason) const;
256 void restoreMemento(const DeckListMemento &m);
257};
258
259#endif
Base class for all nodes in the deck list tree.
Definition abstract_deck_list_node.h:73
Core in-memory container for card and set data.
Definition card_database.h:29
bool readElement(QXmlStreamReader *xml)
Definition deck_list.cpp:61
QStringList getTags() const
Definition deck_list.h:165
DecklistNodeTree * getTree()
Gets a pointer to the underlying node tree. Note: DO NOT call this method unless the object needs to ...
Definition deck_list.h:142
void addTag(const QString &_tag)
Definition deck_list.h:106
QList< CardRef > getCardRefList(const QSet< QString > &restrictToZones={}) const
Definition deck_list.cpp:428
bool saveToFile_Plain(QIODevice *device, bool prefixSideboardCards=true, bool slashTappedOutSplitCards=false) const
Definition deck_list.cpp:390
QMap< QString, SideboardPlan > sideboardPlans
Named sideboard plans.
Definition deck_list.h:82
void setLastLoadedTimestamp(const QString &_lastLoadedTimestamp=QString())
Definition deck_list.h:118
DeckListMemento createMemento(const QString &reason) const
Definition deck_list.cpp:507
const Metadata & getMetadata() const
Definition deck_list.h:153
void setBannerCard(const CardRef &_bannerCard={})
Definition deck_list.h:114
bool loadFromString_Native(const QString &nativeString)
Definition deck_list.cpp:165
void clearTags()
Definition deck_list.h:110
bool isEmpty() const
Definition deck_list.h:224
void refreshDeckHash()
Definition deck_list.cpp:494
QList< const InnerDecklistNode * > getZoneNodes(const QSet< QString > &restrictToZones={}) const
Definition deck_list.cpp:444
bool saveToFile_Native(QIODevice *device) const
Definition deck_list.cpp:187
DeckList()
Construct an empty deck.
Definition deck_list.cpp:31
void setGameFormat(const QString &_gameFormat=QString())
Definition deck_list.h:122
void forEachCard(const std::function< void(InnerDecklistNode *, DecklistCardNode *)> &func) const
Apply a function to every card in the deck tree.
Definition deck_list.cpp:502
bool loadFromFile_Plain(QIODevice *device, const std::function< QString(const QString &)> &cardNameNormalizer)
Definition deck_list.cpp:367
void setCurrentSideboardPlan(const QList< MoveCard_ToZone > &plan)
Definition deck_list.cpp:56
QString getGameFormat() const
Definition deck_list.h:177
void cleanList(bool preserveMetadata=false)
Definition deck_list.cpp:409
QString writeToString_Native() const
Definition deck_list.cpp:171
QString getName() const
Definition deck_list.h:157
bool loadFromXml(QXmlStreamReader *xml)
Definition deck_list.cpp:135
const QMap< QString, SideboardPlan > & getSideboardPlans() const
Definition deck_list.h:192
QString getComments() const
Definition deck_list.h:161
void restoreMemento(const DeckListMemento &m)
Definition deck_list.cpp:512
CardRef getBannerCard() const
Definition deck_list.h:169
QString getLastLoadedTimestamp() const
Definition deck_list.h:173
Metadata metadata
Deck metadata that is stored in the deck file.
Definition deck_list.h:81
bool loadFromFile_Native(QIODevice *device)
Definition deck_list.cpp:181
QList< const DecklistCardNode * > getCardNodes(const QSet< QString > &restrictToZones={}) const
Definition deck_list.cpp:439
void write(QXmlStreamWriter *xml) const
Definition deck_list.cpp:117
QString cachedDeckHash
Cached deck hash, recalculated lazily. An empty string indicates the cache is invalid.
Definition deck_list.h:89
QString getDeckHash() const
Definition deck_list.cpp:481
int getSideboardSize() const
Definition deck_list.cpp:449
QStringList getCardList(const QSet< QString > &restrictToZones={}) const
Definition deck_list.cpp:418
QString writeToString_Plain(bool prefixSideboardCards=true, bool slashTappedOutSplitCards=false) const
Definition deck_list.cpp:396
QList< MoveCard_ToZone > getCurrentSideboardPlan() const
Definition deck_list.cpp:47
bool isBlankDeck() const
Definition deck_list.h:183
bool saveToStream_Plain(QTextStream &stream, bool prefixSideboardCards, bool slashTappedOutSplitCards) const
Definition deck_list.cpp:373
void setComments(const QString &_comments=QString())
Definition deck_list.h:98
void setTags(const QStringList &_tags=QStringList())
Definition deck_list.h:102
DecklistCardNode * addCard(const QString &cardName, const QString &zoneName, int position=-1, const QString &cardSetName=QString(), const QString &cardSetCollectorNumber=QString(), const QString &cardProviderId=QString(), const bool formatLegal=true)
Definition deck_list.cpp:461
bool loadFromStream_Plain(QTextStream &stream, bool preserveMetadata, const std::function< QString(const QString &)> &cardNameNormalizer)
Definition deck_list.cpp:207
DecklistNodeTree tree
The deck tree (zones + cards).
Definition deck_list.h:83
void setName(const QString &_name=QString())
Definition deck_list.h:94
Concrete node type representing an actual card entry in the deck.
Definition deck_list_card_node.h:48
Definition deck_list_node_tree.h:11
Represents a container node in the deck list hierarchy (zones and groupings).
Definition inner_deck_list_node.h:62
Defines the InnerDecklistNode class, which represents structural nodes (zones and groups) in the deck...
Definition card_ref.h:14
Definition deck_list.h:66
QString name
User-defined deck name.
Definition deck_list.h:67
bool isEmpty() const
Checks if all values (except for lastLoadedTimestamp) in the metadata is empty.
Definition deck_list.cpp:26
QString lastLoadedTimestamp
Timestamp string of last load.
Definition deck_list.h:72
QString gameFormat
The name of the game format this deck contains legal cards for.
Definition deck_list.h:69
CardRef bannerCard
Optional representative card for the deck.
Definition deck_list.h:70
QStringList tags
User-defined tags for deck classification.
Definition deck_list.h:71
QString comments
Free-form comments or notes.
Definition deck_list.h:68