// // Struct.hpp // Clock Signal // // Created by Thomas Harte on 06/03/2020. // Copyright © 2020 Thomas Harte. All rights reserved. // #ifndef Struct_hpp #define Struct_hpp #include #include #include #include #include #include #include #include "Enum.hpp" namespace Reflection { #define DeclareField(Name) declare(&Name, #Name) struct Struct { virtual std::vector all_keys() = 0; virtual const std::type_info *type_of(const std::string &name) = 0; virtual void set(const std::string &name, const void *value) = 0; virtual const void *get(const std::string &name) = 0; virtual std::vector values_for(const std::string &name) = 0; virtual ~Struct() {} }; /*! Attempts to set the property @c name to @c value ; will perform limited type conversions. @returns @c true if the property was successfully set; @c false otherwise. */ template bool set(Struct &target, const std::string &name, Type value); /*! Setting an int: * to an int copies the int; * to an int64_t promotes the int; and * to a registered enum, copies the int. */ template <> bool set(Struct &target, const std::string &name, int value); /*! Setting a string: * to an enum, if the string names a member of the enum, sets the value. */ template <> bool set(Struct &target, const std::string &name, const std::string &value); template <> bool set(Struct &target, const std::string &name, const char *value); /*! Setting a bool: * to a bool, copies the value. */ template <> bool set(Struct &target, const std::string &name, bool value); /*! Fuzzy-set attempts to set any property based on a string value. This is intended to allow input provided by the user. Amongst other steps, it might: * if the target is a bool, map true, false, yes, no, y, n, etc; * if the target is an integer, parse like strtrol; * if the target is a float, parse like strtod; or * if the target is a reflective enum, attempt to match to enum members (possibly doing so in a case insensitive fashion). This method reserves the right to perform more or fewer attempted mappings, using any other logic it decides is appropriate. @returns @c true if the property was successfully set; @c false otherwise. */ bool fuzzy_set(Struct &target, const std::string &name, const std::string &value); /*! Attempts to get the property @c name to @c value ; will perform limited type conversions. @returns @c true if the property was successfully read; @c false otherwise. */ template bool get(Struct &target, const std::string &name, Type &value); template <> bool get(Struct &target, const std::string &name, bool &value); // TODO: move this elsewhere. It's just a sketch anyway. struct Serialisable { /// Serialises this object, appending it to @c target. virtual void serialise(std::vector &target) = 0; /// Deserialises this object from @c source. /// @returns @c true if the deserialisation was successful; @c false otherwise. virtual bool deserialise(const std::vector &source) = 0; }; template class StructImpl: public Struct { public: /*! @returns the value of type @c Type that is loaded from the offset registered for the field @c name. It is the caller's responsibility to provide an appropriate type of data. */ const void *get(const std::string &name) final { const auto iterator = contents_.find(name); if(iterator == contents_.end()) return nullptr; return reinterpret_cast(this) + iterator->second.offset; } /*! Stores the @c value of type @c Type to the offset registered for the field @c name. It is the caller's responsibility to provide an appropriate type of data. */ void set(const std::string &name, const void *value) final { const auto iterator = contents_.find(name); if(iterator == contents_.end()) return; memcpy(reinterpret_cast(this) + iterator->second.offset, value, iterator->second.size); } /*! @returns @c type_info for the field @c name. */ const std::type_info *type_of(const std::string &name) final { const auto iterator = contents_.find(name); if(iterator == contents_.end()) return nullptr; return iterator->second.type; } /*! @returns a list of the valid enum value names for field @c name if it is a declared enum field of this struct; the empty list otherwise. */ std::vector values_for(const std::string &name) final { std::vector result; // Return an empty vector if this field isn't declared. const auto type = type_of(name); if(!type) return result; // Also return an empty vector if this field isn't a registered enum. const auto all_values = Enum::all_values(*type); if(all_values.empty()) return result; // If no restriction is stored, return all values. const auto permitted_values = permitted_enum_values_.find(name); if(permitted_values == permitted_enum_values_.end()) return all_values; // Compile a vector of only those values the stored set indicates. auto value = all_values.begin(); auto flag = permitted_values->second.begin(); while(value != all_values.end() && flag != permitted_values->second.end()) { if(*flag) { result.push_back(*value); } ++flag; ++value; } return result; } /*! @returns A vector of all declared fields for this struct. */ std::vector all_keys() final { std::vector keys; for(const auto &pair: contents_) { keys.push_back(pair.first); } return keys; } protected: /* This interface requires reflective structs to declare all fields; specifically they should call: declare_field(&field1, "field1"); declare_field(&field2, "field2"); Fields are registered in class storage. So callers can use needs_declare() to determine whether a class of this type has already established the reflective fields. */ /*! Exposes the field pointed to by @c t for reflection as @c name. */ template void declare(Type *t, const std::string &name) { contents_.emplace( std::make_pair( name, Field(typeid(Type), reinterpret_cast(t) - reinterpret_cast(this), sizeof(Type)) )); } /*! If @c t is a previously-declared field that links to a declared enum then the variable arguments provide a list of the acceptable values for that field. The list should be terminated with a value of -1. */ template void limit_enum(Type *t, ...) { const auto name = name_of(t); if(name.empty()) return; // The default vector size of '8' isn't especially scientific, // but I feel like it's a good choice. std::vector permitted_values(8); va_list list; va_start(list, t); while(true) { const int next = va_arg(list, int); if(next < 0) break; if(permitted_values.size() <= size_t(next)) { permitted_values.resize(permitted_values.size() << 1); } permitted_values[size_t(next)] = true; } va_end(list); permitted_enum_values_.emplace(std::make_pair(name, permitted_values)); } /*! @returns @c true if this subclass of @c Struct has not yet declared any fields. */ bool needs_declare() { return !contents_.size(); } /*! Performs a reverse lookup from field to name. */ std::string name_of(void *field) { const ssize_t offset = reinterpret_cast(field) - reinterpret_cast(this); auto iterator = contents_.begin(); while(iterator != contents_.end()) { if(iterator->second.offset == offset) break; ++iterator; } if(iterator != contents_.end()) { return iterator->first; } else { return ""; } } private: struct Field { const std::type_info *type; ssize_t offset; size_t size; Field(const std::type_info &type, ssize_t offset, size_t size) : type(&type), offset(offset), size(size) {} }; static inline std::unordered_map contents_; static inline std::unordered_map> permitted_enum_values_; }; } #endif /* Struct_hpp */