Cockatrice 2025-11-30-Development-2.11.0-beta.38
A cross-platform virtual tabletop for multiplayer card games
Loading...
Searching...
No Matches
card_database_querier.h
Go to the documentation of this file.
1#ifndef COCKATRICE_CARD_DATABASE_QUERIER_H
2#define COCKATRICE_CARD_DATABASE_QUERIER_H
3
4#include "../card_info.h"
6
7#include <QObject>
10
11class CardDatabase;
12
22class CardDatabaseQuerier : public QObject
23{
24 Q_OBJECT
25
26public:
34 explicit CardDatabaseQuerier(QObject *parent, const CardDatabase *db, const ICardPreferenceProvider *prefs);
35
42 [[nodiscard]] CardInfoPtr getCardInfo(const QString &cardName) const;
43
52 [[nodiscard]] QList<CardInfoPtr> getCardInfos(const QStringList &cardNames) const;
53
62 [[nodiscard]] CardInfoPtr getCardBySimpleName(const QString &cardName) const;
63
70 [[nodiscard]] CardInfoPtr lookupCardByName(const QString &name) const;
71
81 [[nodiscard]] ExactCard getCard(const CardRef &cardRef) const;
82
91 [[nodiscard]] QList<ExactCard> getCards(const QList<CardRef> &cardRefs) const;
92
101 [[nodiscard]] ExactCard guessCard(const CardRef &cardRef) const;
102
108 [[nodiscard]] ExactCard getRandomCard() const;
109
119 [[nodiscard]] ExactCard getCardFromSameSet(const QString &cardName, const PrintingInfo &otherPrinting) const;
120
127 [[nodiscard]] ExactCard getPreferredCard(const QString &cardName) const;
128
135 [[nodiscard]] ExactCard getPreferredCard(const CardInfoPtr &cardInfo) const;
136
143 [[nodiscard]] bool isPreferredPrinting(const CardRef &cardRef) const;
144
151 [[nodiscard]] PrintingInfo getPreferredPrinting(const QString &cardName) const;
152
159 [[nodiscard]] PrintingInfo getPreferredPrinting(const CardInfoPtr &cardInfo) const;
160
167 [[nodiscard]] QString getPreferredPrintingProviderId(const QString &cardName) const;
168
175 [[nodiscard]] PrintingInfo getSpecificPrinting(const CardRef &cardRef) const;
176
185 [[nodiscard]] PrintingInfo
186 getSpecificPrinting(const QString &cardName, const QString &setCode, const QString &collectorNumber) const;
187
195 [[nodiscard]] PrintingInfo findPrintingWithId(const CardInfoPtr &card, const QString &providerId) const;
196
202 [[nodiscard]] QStringList getAllMainCardTypes() const;
203
209 [[nodiscard]] QMap<QString, int> getAllMainCardTypesWithCount() const;
210
216 [[nodiscard]] QMap<QString, int> getAllSubCardTypesWithCount() const;
217
218private:
221};
222
223#endif // COCKATRICE_CARD_DATABASE_QUERIER_H
QSharedPointer< CardInfo > CardInfoPtr
Definition card_info.cpp:20
bool isPreferredPrinting(const CardRef &cardRef) const
Checks whether the CardRef refers to the preferred printing.
Definition card_database_querier.cpp:232
QMap< QString, int > getAllMainCardTypesWithCount() const
Returns a mapping of main card types to their occurrence counts.
Definition card_database_querier.cpp:309
PrintingInfo findPrintingWithId(const CardInfoPtr &card, const QString &providerId) const
Searches for a printing that matches a given providerId.
Definition card_database_querier.cpp:155
PrintingInfo getPreferredPrinting(const QString &cardName) const
Returns the preferred printing for the given card name.
Definition card_database_querier.cpp:241
const ICardPreferenceProvider * prefs
Preference provider for preferred printings.
Definition card_database_querier.h:220
QString getPreferredPrintingProviderId(const QString &cardName) const
Returns the providerId of the preferred printing.
Definition card_database_querier.cpp:285
const CardDatabase * db
Card database used for all lookups.
Definition card_database_querier.h:219
ExactCard getRandomCard() const
Returns a random card from the database using the preferred printing.
Definition card_database_querier.cpp:120
QList< ExactCard > getCards(const QList< CardRef > &cardRefs) const
Resolves multiple CardRefs into ExactCards.
Definition card_database_querier.cpp:69
ExactCard getCard(const CardRef &cardRef) const
Converts a CardRef into an ExactCard.
Definition card_database_querier.cpp:89
CardInfoPtr lookupCardByName(const QString &name) const
Looks up a card using exact name first, then simplified matching as fallback.
Definition card_database_querier.cpp:51
PrintingInfo getSpecificPrinting(const CardRef &cardRef) const
Retrieves a specific printing referenced by CardRef.
Definition card_database_querier.cpp:168
ExactCard guessCard(const CardRef &cardRef) const
Attempts a more flexible card lookup using both simple name matching and CardRef rules.
Definition card_database_querier.cpp:111
ExactCard getCardFromSameSet(const QString &cardName, const PrintingInfo &otherPrinting) const
Returns a printing of a card from the same set as another given printing when possible.
Definition card_database_querier.cpp:133
QList< CardInfoPtr > getCardInfos(const QStringList &cardNames) const
Retrieves multiple cards by their exact names.
Definition card_database_querier.cpp:34
CardInfoPtr getCardBySimpleName(const QString &cardName) const
Retrieves a card using simplified name matching.
Definition card_database_querier.cpp:46
CardInfoPtr getCardInfo(const QString &cardName) const
Retrieves a card by its exact name.
Definition card_database_querier.cpp:23
QMap< QString, int > getAllSubCardTypesWithCount() const
Returns a mapping of card subtypes to their occurrence counts.
Definition card_database_querier.cpp:321
CardDatabaseQuerier(QObject *parent, const CardDatabase *db, const ICardPreferenceProvider *prefs)
Constructs a CardDatabaseQuerier.
Definition card_database_querier.cpp:10
QStringList getAllMainCardTypes() const
Returns a list of all main card types present in the database.
Definition card_database_querier.cpp:300
ExactCard getPreferredCard(const QString &cardName) const
Returns the preferred printing of a card based on user preferences and set priority.
Definition card_database_querier.cpp:216
Core in-memory container for card and set data.
Definition card_database.h:29
Represents a specific card instance, defined by its CardInfo and a particular printing.
Definition exact_card.h:19
Definition interface_card_preference_provider.h:7
Represents metadata for a specific variation of a card within a set.
Definition printing_info.h:27
Definition card_ref.h:14