bimap_core.hpp 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477
  1. // Boost.Bimap
  2. //
  3. // Copyright (c) 2006-2007 Matias Capeletto
  4. //
  5. // Distributed under the Boost Software License, Version 1.0.
  6. // (See accompanying file LICENSE_1_0.txt or copy at
  7. // http://www.boost.org/LICENSE_1_0.txt)
  8. /// \file detail/bimap_core.hpp
  9. /// \brief Bimap base definition.
  10. #ifndef BOOST_BIMAP_DETAIL_BIMAP_CORE_HPP
  11. #define BOOST_BIMAP_DETAIL_BIMAP_CORE_HPP
  12. #if defined(_MSC_VER)
  13. #pragma once
  14. #endif
  15. #include <boost/config.hpp>
  16. #include <boost/mpl/placeholders.hpp>
  17. #include <boost/mpl/push_front.hpp>
  18. #include <boost/mpl/if.hpp>
  19. #include <boost/mpl/and.hpp>
  20. #include <boost/mpl/not.hpp>
  21. #include <boost/mpl/vector.hpp>
  22. #include <boost/type_traits/add_const.hpp>
  23. #include <boost/type_traits/is_same.hpp>
  24. #include <boost/concept_check.hpp>
  25. // Boost.MultiIndex
  26. #include <boost/multi_index_container.hpp>
  27. #include <boost/multi_index/member.hpp>
  28. // Boost.Bimap
  29. #include <boost/bimap/relation/mutant_relation.hpp>
  30. #include <boost/bimap/relation/member_at.hpp>
  31. #include <boost/bimap/relation/support/data_extractor.hpp>
  32. #include <boost/bimap/tags/support/default_tagged.hpp>
  33. #include <boost/bimap/tags/tagged.hpp>
  34. #include <boost/bimap/detail/manage_bimap_key.hpp>
  35. #include <boost/bimap/detail/manage_additional_parameters.hpp>
  36. #include <boost/bimap/detail/map_view_iterator.hpp>
  37. #include <boost/bimap/detail/set_view_iterator.hpp>
  38. #include <boost/bimap/set_of.hpp>
  39. #include <boost/bimap/unconstrained_set_of.hpp>
  40. namespace boost {
  41. namespace bimaps {
  42. /// \brief Library details
  43. namespace detail {
  44. #ifndef BOOST_BIMAP_DOXYGEN_WILL_NOT_PROCESS_THE_FOLLOWING_LINES
  45. template< class Type >
  46. struct get_value_type
  47. {
  48. typedef BOOST_DEDUCED_TYPENAME Type::value_type type;
  49. };
  50. struct independent_index_tag {};
  51. #endif // BOOST_BIMAP_DOXYGEN_WILL_NOT_PROCESS_THE_FOLLOWING_LINES
  52. /// \brief Base for the bimap class.
  53. /**
  54. See also bimap.
  55. **/
  56. template< class LeftSetType, class RightSetType, class AP1, class AP2, class AP3 >
  57. class bimap_core
  58. {
  59. // Manage bimap key instantiation
  60. // --------------------------------------------------------------------
  61. public:
  62. typedef BOOST_DEDUCED_TYPENAME manage_bimap_key
  63. <
  64. LeftSetType
  65. >::type left_set_type;
  66. typedef BOOST_DEDUCED_TYPENAME manage_bimap_key
  67. <
  68. RightSetType
  69. >::type right_set_type;
  70. private:
  71. typedef BOOST_DEDUCED_TYPENAME ::boost::bimaps::tags::support::default_tagged
  72. <
  73. BOOST_DEDUCED_TYPENAME left_set_type::user_type,
  74. ::boost::bimaps::relation::member_at::left
  75. >::type left_tagged_type;
  76. typedef BOOST_DEDUCED_TYPENAME ::boost::bimaps::tags::support::default_tagged
  77. <
  78. BOOST_DEDUCED_TYPENAME right_set_type::user_type,
  79. ::boost::bimaps::relation::member_at::right
  80. >::type right_tagged_type;
  81. public:
  82. //@{
  83. typedef BOOST_DEDUCED_TYPENAME left_tagged_type::tag left_tag;
  84. typedef BOOST_DEDUCED_TYPENAME right_tagged_type::tag right_tag;
  85. //@}
  86. //@{
  87. typedef BOOST_DEDUCED_TYPENAME left_set_type::value_type left_key_type;
  88. typedef BOOST_DEDUCED_TYPENAME right_set_type::value_type right_key_type;
  89. //@}
  90. //@{
  91. typedef right_key_type left_data_type;
  92. typedef left_key_type right_data_type;
  93. //@}
  94. // Manage the additional parameters
  95. // --------------------------------------------------------------------
  96. private:
  97. typedef BOOST_DEDUCED_TYPENAME manage_additional_parameters<AP1,AP2,AP3>::type parameters;
  98. /// \brief Relation type stored by the bimap.
  99. // --------------------------------------------------------------------
  100. public:
  101. typedef ::boost::bimaps::relation::mutant_relation
  102. <
  103. ::boost::bimaps::tags::tagged<
  104. BOOST_DEDUCED_TYPENAME mpl::if_<
  105. mpl::and_
  106. <
  107. BOOST_DEDUCED_TYPENAME left_set_type::mutable_key,
  108. BOOST_DEDUCED_TYPENAME parameters::set_type_of_relation::left_mutable_key
  109. >,
  110. // {
  111. left_key_type,
  112. // }
  113. // else
  114. // {
  115. BOOST_DEDUCED_TYPENAME ::boost::add_const< left_key_type >::type
  116. // }
  117. >::type,
  118. left_tag
  119. >,
  120. ::boost::bimaps::tags::tagged<
  121. BOOST_DEDUCED_TYPENAME mpl::if_<
  122. mpl::and_
  123. <
  124. BOOST_DEDUCED_TYPENAME right_set_type::mutable_key,
  125. BOOST_DEDUCED_TYPENAME parameters::set_type_of_relation::right_mutable_key
  126. >,
  127. // {
  128. right_key_type,
  129. // }
  130. // else
  131. // {
  132. BOOST_DEDUCED_TYPENAME ::boost::add_const< right_key_type >::type
  133. // }
  134. >::type,
  135. right_tag
  136. >,
  137. // It is ::boost::mpl::na if no info_hook was included
  138. BOOST_DEDUCED_TYPENAME parameters::additional_info,
  139. // Force mutable keys
  140. true
  141. > relation;
  142. //@{
  143. typedef BOOST_DEDUCED_TYPENAME relation::left_pair left_value_type;
  144. typedef BOOST_DEDUCED_TYPENAME relation::right_pair right_value_type;
  145. //@}
  146. // Bind the member of the relation, so multi_index can manage them
  147. // --------------------------------------------------------------------
  148. private:
  149. typedef BOOST_DEDUCED_TYPENAME relation::storage_base relation_storage_base;
  150. typedef BOOST_MULTI_INDEX_MEMBER(relation_storage_base, left_key_type, left)
  151. left_member_extractor;
  152. typedef BOOST_MULTI_INDEX_MEMBER(relation_storage_base,right_key_type,right)
  153. right_member_extractor;
  154. // The core indices are somewhat complicated to calculate, because they
  155. // can be zero, one, two or three indices, depending on the use of
  156. // {side}_based set type of relations and unconstrained_set_of and
  157. // unconstrained_set_of_relation specifications.
  158. typedef BOOST_DEDUCED_TYPENAME mpl::if_<
  159. ::boost::bimaps::detail::is_unconstrained_set_of< left_set_type >,
  160. // {
  161. mpl::vector<>,
  162. // }
  163. // else
  164. // {
  165. mpl::vector
  166. <
  167. BOOST_DEDUCED_TYPENAME left_set_type::
  168. BOOST_NESTED_TEMPLATE index_bind
  169. <
  170. left_member_extractor,
  171. left_tag
  172. >::type
  173. >
  174. // }
  175. >::type left_core_indices;
  176. typedef BOOST_DEDUCED_TYPENAME mpl::if_<
  177. ::boost::bimaps::detail::is_unconstrained_set_of< right_set_type >,
  178. // {
  179. left_core_indices,
  180. // }
  181. // else
  182. // {
  183. BOOST_DEDUCED_TYPENAME mpl::push_front
  184. <
  185. left_core_indices,
  186. BOOST_DEDUCED_TYPENAME right_set_type::
  187. BOOST_NESTED_TEMPLATE index_bind
  188. <
  189. right_member_extractor,
  190. right_tag
  191. >::type
  192. >::type
  193. // }
  194. >::type basic_core_indices;
  195. // If it is based either on the left or on the right, then only the side
  196. // indices are needed. But the set type of the relation can be completely
  197. // diferent from the one used for the sides in wich case we have to add yet
  198. // another index to the core.
  199. // TODO
  200. // If all the set types are unsconstrained there must be readable compile
  201. // time error.
  202. typedef BOOST_DEDUCED_TYPENAME mpl::if_<
  203. is_same< BOOST_DEDUCED_TYPENAME parameters::set_type_of_relation, left_based >,
  204. // {
  205. ::boost::bimaps::tags::tagged< left_set_type, left_tag >,
  206. // }
  207. /* else */ BOOST_DEDUCED_TYPENAME mpl::if_<
  208. is_same< BOOST_DEDUCED_TYPENAME parameters::set_type_of_relation, right_based >,
  209. // {
  210. ::boost::bimaps::tags::tagged< right_set_type, right_tag >,
  211. // }
  212. // else
  213. // {
  214. tags::tagged
  215. <
  216. BOOST_DEDUCED_TYPENAME parameters::
  217. set_type_of_relation::BOOST_NESTED_TEMPLATE bind_to
  218. <
  219. relation
  220. >::type,
  221. independent_index_tag
  222. >
  223. // }
  224. >::type
  225. >::type tagged_set_of_relation_type;
  226. protected:
  227. typedef BOOST_DEDUCED_TYPENAME tagged_set_of_relation_type::tag
  228. relation_set_tag;
  229. typedef BOOST_DEDUCED_TYPENAME tagged_set_of_relation_type::value_type
  230. relation_set_type_of;
  231. // Logic tags
  232. // This is a necesary extra level of indirection to allow unconstrained
  233. // sets to be plug in the design. The bimap constructors use this logic
  234. // tags.
  235. typedef BOOST_DEDUCED_TYPENAME mpl::if_<
  236. ::boost::bimaps::detail::is_unconstrained_set_of< left_set_type >,
  237. BOOST_DEDUCED_TYPENAME mpl::if_<
  238. ::boost::bimaps::detail::is_unconstrained_set_of< right_set_type >,
  239. independent_index_tag,
  240. right_tag
  241. >::type,
  242. left_tag
  243. >::type logic_left_tag;
  244. typedef BOOST_DEDUCED_TYPENAME mpl::if_<
  245. ::boost::bimaps::detail::is_unconstrained_set_of< right_set_type >,
  246. BOOST_DEDUCED_TYPENAME mpl::if_<
  247. ::boost::bimaps::detail::is_unconstrained_set_of< left_set_type >,
  248. independent_index_tag,
  249. left_tag
  250. >::type,
  251. right_tag
  252. >::type logic_right_tag;
  253. typedef BOOST_DEDUCED_TYPENAME mpl::if_<
  254. is_same< relation_set_tag, independent_index_tag >,
  255. BOOST_DEDUCED_TYPENAME mpl::if_<
  256. ::boost::bimaps::detail::
  257. is_unconstrained_set_of< relation_set_type_of >,
  258. logic_left_tag,
  259. independent_index_tag
  260. >::type,
  261. BOOST_DEDUCED_TYPENAME mpl::if_<
  262. is_same< BOOST_DEDUCED_TYPENAME parameters::set_type_of_relation, left_based >,
  263. logic_left_tag,
  264. logic_right_tag
  265. >::type
  266. >::type logic_relation_set_tag;
  267. private:
  268. typedef BOOST_DEDUCED_TYPENAME mpl::if_<
  269. mpl::and_< is_same< relation_set_tag, independent_index_tag >,
  270. mpl::not_<
  271. ::boost::bimaps::detail::
  272. is_unconstrained_set_of< relation_set_type_of >
  273. >
  274. >,
  275. // {
  276. BOOST_DEDUCED_TYPENAME mpl::push_front
  277. <
  278. basic_core_indices,
  279. BOOST_DEDUCED_TYPENAME relation_set_type_of::
  280. BOOST_NESTED_TEMPLATE index_bind
  281. <
  282. ::boost::bimaps::relation::support::both_keys_extractor<relation>,
  283. independent_index_tag
  284. >::type
  285. >::type,
  286. // }
  287. // else
  288. // {
  289. basic_core_indices
  290. // }
  291. >::type complete_core_indices;
  292. struct core_indices : public complete_core_indices {};
  293. // Define the core using compute_index_type to translate the
  294. // set type to an multi-index specification
  295. // --------------------------------------------------------------------
  296. public:
  297. typedef multi_index::multi_index_container
  298. <
  299. relation,
  300. core_indices,
  301. BOOST_DEDUCED_TYPENAME parameters::allocator::
  302. BOOST_NESTED_TEMPLATE rebind<relation>::other
  303. > core_type;
  304. // Core metadata
  305. // --------------------------------------------------------------------
  306. public:
  307. typedef BOOST_DEDUCED_TYPENAME ::boost::multi_index::
  308. index<core_type, logic_left_tag>::type left_index;
  309. typedef BOOST_DEDUCED_TYPENAME ::boost::multi_index::
  310. index<core_type,logic_right_tag>::type right_index;
  311. typedef BOOST_DEDUCED_TYPENAME left_index::iterator left_core_iterator;
  312. typedef BOOST_DEDUCED_TYPENAME left_index::const_iterator left_core_const_iterator;
  313. typedef BOOST_DEDUCED_TYPENAME right_index::iterator right_core_iterator;
  314. typedef BOOST_DEDUCED_TYPENAME right_index::const_iterator right_core_const_iterator;
  315. // Relation set view
  316. typedef BOOST_DEDUCED_TYPENAME ::boost::multi_index::index
  317. <
  318. core_type, logic_relation_set_tag
  319. >::type relation_set_core_index;
  320. typedef BOOST_DEDUCED_TYPENAME relation_set_type_of::
  321. BOOST_NESTED_TEMPLATE set_view_bind
  322. <
  323. relation_set_core_index
  324. >::type relation_set;
  325. public:
  326. typedef bimap_core bimap_core_;
  327. };
  328. // Two auxiliar metafunctions to compute the map view types
  329. // The map view type can not be computed inside the bimap core because a
  330. // they need the bimap core to be parsed first.
  331. template< class BimapBaseType >
  332. struct left_map_view_type
  333. {
  334. typedef BOOST_DEDUCED_TYPENAME BimapBaseType::left_set_type left_set_type;
  335. typedef BOOST_DEDUCED_TYPENAME
  336. left_set_type::BOOST_NESTED_TEMPLATE map_view_bind<
  337. BOOST_DEDUCED_TYPENAME BimapBaseType::left_tag, BimapBaseType
  338. >::type type;
  339. };
  340. template< class BimapBaseType >
  341. struct right_map_view_type
  342. {
  343. typedef BOOST_DEDUCED_TYPENAME BimapBaseType::right_set_type right_set_type;
  344. typedef BOOST_DEDUCED_TYPENAME
  345. right_set_type::BOOST_NESTED_TEMPLATE map_view_bind<
  346. BOOST_DEDUCED_TYPENAME BimapBaseType::right_tag, BimapBaseType
  347. >::type type;
  348. };
  349. } // namespace detail
  350. } // namespace bimaps
  351. } // namespace boost
  352. #endif // BOOST_BIMAP_DETAIL_BIMAP_CORE_HPP