TagStore.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
#include "tags/GameplayTag.h"
 
#include <cstdint>
#include <map>
#include <set>
#include <string>
#include <vector>
 
namespace eve::tags {
 
using SubjectId = std::string;
 
struct TagChangeEvent {
    std::uint64_t sequence = 0;
    std::string   action;
    SubjectId     subject;
    std::string   value;
};
 
class EVENGINE_API_FOUNDATION TagStore {
public:
    bool addTag(const SubjectId& subject, const std::string& tag);
    bool removeTag(const SubjectId& subject, const std::string& tag);
    bool hasTag(const SubjectId& subject, const std::string& tag) const;
    bool hasTagMatching(const SubjectId& subject, const std::string& tag, GameplayTagMatch match) const;
    std::vector<std::string> tagsOf(const SubjectId& subject) const;
    std::vector<SubjectId> subjectsWithTag(const std::string& tag) const;
    std::vector<SubjectId> subjectsWithTagMatching(const std::string& tag, GameplayTagMatch match) const;
    bool requireAllTags(const SubjectId& subject, const std::vector<std::string>& tags) const;
    bool requireAnyTag(const SubjectId& subject, const std::vector<std::string>& tags) const;
    bool matchesAllTags(const SubjectId& subject, const std::vector<std::string>& tags,
                        GameplayTagMatch match) const;
    bool matchesAnyTag(const SubjectId& subject, const std::vector<std::string>& tags,
                       GameplayTagMatch match) const;
 
    bool addCapability(const SubjectId& subject, const std::string& capability);
    bool removeCapability(const SubjectId& subject, const std::string& capability);
    bool hasCapability(const SubjectId& subject, const std::string& capability) const;
    std::vector<std::string> capabilitiesOf(const SubjectId& subject) const;
    bool requireAllCapabilities(const SubjectId& subject, const std::vector<std::string>& capabilities) const;
    bool requireAnyCapability(const SubjectId& subject, const std::vector<std::string>& capabilities) const;
 
    bool removeSubject(const SubjectId& subject);
    void clear();
    const std::vector<TagChangeEvent>& events() const { return events_; }
    void clearEvents() { events_.clear(); }
 
private:
    using ValueSet = std::set<std::string>;
    using Index    = std::map<std::string, std::set<SubjectId>>;
 
    bool mutate(std::map<SubjectId, ValueSet>& values, Index* reverse, const SubjectId& subject,
                const std::string& value, bool add, const char* addedAction, const char* removedAction);
    static std::vector<std::string> values(const ValueSet* set);
    static bool                     requireAll(const ValueSet* held, const std::vector<std::string>& requested);
    static bool                     requireAny(const ValueSet* held, const std::vector<std::string>& requested);
    void                            emit(std::string action, SubjectId subject, std::string value);
 
    std::map<SubjectId, ValueSet> tags_;
    std::map<SubjectId, ValueSet> capabilities_;
    Index                         subjectsByTag_;
    std::vector<TagChangeEvent>   events_;
    std::uint64_t                 nextSequence_ = 1;
};
 
}  // namespace eve::tags