/** * @file fc/reflect.hpp * * @brief Defines types and macros used to provide reflection. * */ #ifndef _FC_REFLECT_HPP_ #define _FC_REFLECT_HPP_ #include #include //#include #include #include #include #include //#include //#include #include //#include //#include namespace fc { /** * @brief defines visit functions for T * Unless this is specialized, visit() will not be defined for T. * * @tparam T - the type that will be visited. * * The @ref FC_REFLECT(TYPE,MEMBERS) or FC_STATIC_REFLECT_DERIVED(TYPE,BASES,MEMBERS) macro is used to specialize this * class for your type. */ template struct reflector{ typedef T type; typedef fc::false_type is_defined; typedef fc::false_type is_enum; /** * @tparam Visitor a function object of the form: * * @code * struct functor { * template * void operator()( const char* name )const; * }; * @endcode * * If T is an enum then the functor has the following form: * @code * struct functor { * template * void operator()( const char* name )const; * }; * @endcode * * @param v a functor that will be called for each member on T * * @note - this method is not defined for non-reflected types. */ #ifdef DOXYGEN template static inline void visit( const Visitor& v ); #endif // DOXYGEN }; } // namespace fc #ifndef DOXYGEN #define FC_REFLECT_VISIT_BASE(r, visitor, base) \ fc::reflector::visit( visitor ); #ifndef WIN32 #define TEMPLATE template #else #define TEMPLATE #endif //#include #define FC_REFLECT_VISIT_MEMBER( r, visitor, elem ) \ visitor.TEMPLATE operator()elem), type, &type::elem>( BOOST_PP_STRINGIZE(elem) ); #define FC_REFLECT_BASE_MEMBER_COUNT( r, OP, elem ) \ OP fc::reflector::member_count #define FC_REFLECT_DERIVED_IMPL_INLINE( TYPE, INHERITS, MEMBERS ) \ template\ static inline void visit( const Visitor& v ) { \ BOOST_PP_SEQ_FOR_EACH( FC_REFLECT_VISIT_BASE, v, INHERITS ) \ BOOST_PP_SEQ_FOR_EACH( FC_REFLECT_VISIT_MEMBER, v, MEMBERS ) \ } #define FC_REFLECT_DERIVED_IMPL_EXT( TYPE, INHERITS, MEMBERS ) \ template\ void fc::reflector::visit( const Visitor& v ) { \ BOOST_PP_SEQ_FOR_EACH( FC_REFLECT_VISIT_BASE, v, INHERITS ) \ BOOST_PP_SEQ_FOR_EACH( FC_REFLECT_VISIT_MEMBER, v, MEMBERS ) \ } #endif // DOXYGEN #define FC_REFLECT_VISIT_ENUM( r, visitor, elem ) \ visitor.TEMPLATE operator()(BOOST_PP_STRINGIZE(elem)); #define FC_REFLECT_ENUM_TO_STRING( r, visitor, elem ) \ case elem: return BOOST_PP_STRINGIZE(elem); #define FC_REFLECT_ENUM_FROM_STRING( r, visitor, elem ) \ if( strcmp( s, BOOST_PP_STRINGIZE(elem) ) == 0 ) return elem; #define FC_REFLECT_ENUM( ENUM, FIELDS ) \ namespace fc { \ template<> struct reflector { \ typedef fc::true_type is_defined; \ typedef fc::true_type is_enum; \ template \ static inline void visit( const Visitor& v ) { \ BOOST_PP_SEQ_FOR_EACH( FC_REFLECT_VISIT_ENUM, v, FIELDS ) \ }\ static const char* to_string(int64_t i) { \ switch( ENUM(i) ) { \ BOOST_PP_SEQ_FOR_EACH( FC_REFLECT_ENUM_TO_STRING, v, FIELDS ) \ default: \ FC_REFLECT_THROW( fc::reflect::unknown_field(), "%1% not in enum '%2%'", %i %BOOST_PP_STRINGIZE(ENUM) ); \ }\ } \ static ENUM from_string( const char* s ) { \ BOOST_PP_SEQ_FOR_EACH( FC_REFLECT_ENUM_FROM_STRING, v, FIELDS ) \ FC_REFLECT_THROW( fc::reflect::unknown_field(), "%1% in enum %2%", %s %BOOST_PP_STRINGIZE(ENUM) ); \ } \ }; \ } } /** * @def FC_REFLECT_DERIVED(TYPE,INHERITS,MEMBERS) * * @brief Specializes fc::reflector for TYPE where * type inherits other reflected classes * * @param INHERITS - a sequence of base class names (basea)(baseb)(basec) * @param MEMBERS - a sequence of member names. (field1)(field2)(field3) */ #define FC_REFLECT_DERIVED( TYPE, INHERITS, MEMBERS ) \ namespace fc { \ template<> struct reflector {\ typedef TYPE type; \ typedef fc::true_type is_defined; \ typedef fc::false_type is_enum; \ enum member_count_enum { \ local_member_count = BOOST_PP_SEQ_SIZE(MEMBERS), \ total_member_count = local_member_count BOOST_PP_SEQ_FOR_EACH( FC_REFLECT_BASE_MEMBER_COUNT, +, INHERITS )\ }; \ FC_REFLECT_DERIVED_IMPL_INLINE( TYPE, INHERITS, MEMBERS ) \ }; } /** * @def FC_REFLECT(TYPE,MEMBERS) * @brief Specializes fc::reflector for TYPE * * @param MEMBERS - a sequence of member names. (field1)(field2)(field3) * * @see FC_REFLECT_DERIVED */ #define FC_REFLECT( TYPE, MEMBERS ) \ FC_REFLECT_DERIVED( TYPE, BOOST_PP_SEQ_NIL, MEMBERS ) #define FC_REFLECT_FWD( TYPE ) \ namespace fc { \ template<> struct reflector {\ typedef TYPE type; \ typedef fc::true_type is_defined; \ enum member_count_enum { \ local_member_count = BOOST_PP_SEQ_SIZE(MEMBERS), \ total_member_count = local_member_count BOOST_PP_SEQ_FOR_EACH( FC_REFLECT_BASE_MEMBER_COUNT, +, INHERITS )\ }; \ template static void visit( const Visitor& v ); \ }; } #define FC_REFLECT_DERIVED_IMPL( TYPE, MEMBERS ) \ FC_REFLECT_IMPL_DERIVED_EXT( TYPE, BOOST_PP_SEQ_NIL, MEMBERS ) #define FC_REFLECT_IMPL( TYPE, MEMBERS ) \ FC_REFLECT_DERIVED_IMPL_EXT( TYPE, BOOST_PP_SEQ_NIL, MEMBERS ) #endif