1 // Boost.Assign library
3 // Copyright Thorsten Ottosen 2003-2004. Use, modification and
4 // distribution is subject to the Boost Software License, Version
5 // 1.0. (See accompanying file LICENSE_1_0.txt or copy at
6 // http://www.boost.org/LICENSE_1_0.txt)
8 // For more information, see http://www.boost.org/libs/assign/
12 #ifndef BOOST_ASSIGN_LIST_OF_HPP
13 #define BOOST_ASSIGN_LIST_OF_HPP
19 #include <boost/assign/assignment_exception.hpp>
20 #include <boost/range/iterator_range.hpp>
21 #include <boost/config.hpp>
22 #include <boost/tuple/tuple.hpp>
23 #include <boost/type_traits/remove_const.hpp>
24 #include <boost/type_traits/remove_reference.hpp>
25 #include <boost/type_traits/is_reference.hpp>
26 #include <boost/static_assert.hpp>
27 #include <boost/throw_exception.hpp>
28 #include <boost/type_traits/detail/yes_no_type.hpp>
29 #include <boost/type_traits/decay.hpp>
30 #include <boost/type_traits/is_array.hpp>
31 #include <boost/mpl/if.hpp>
36 #include <boost/preprocessor/repetition/enum_binary_params.hpp>
37 #include <boost/preprocessor/repetition/enum_params.hpp>
38 #include <boost/preprocessor/iteration/local.hpp>
40 #if BOOST_WORKAROUND(__BORLANDC__, BOOST_TESTED_AT(0x564))
41 // BCB requires full type definition for is_array<> to work correctly.
42 #include <boost/array.hpp>
48 // this here is necessary to avoid compiler error in <boost/array.hpp>
49 #if !BOOST_WORKAROUND(__BORLANDC__, BOOST_TESTED_AT(0x564))
50 template< class T, std::size_t sz >
54 namespace assign_detail
56 /////////////////////////////////////////////////////////////////////////
57 // Part 0: common conversion code
58 /////////////////////////////////////////////////////////////////////////
64 // Add constness to array parameters
65 // to support string literals properly
67 typedef BOOST_DEDUCED_TYPENAME mpl::eval_if<
69 ::boost::decay<const T>,
70 ::boost::decay<T> >::type type;
73 template< class T, std::size_t sz >
74 type_traits::yes_type assign_is_array( const array<T,sz>* );
75 type_traits::no_type assign_is_array( ... );
76 template< class T, class U >
77 type_traits::yes_type assign_is_pair( const std::pair<T,U>* );
78 type_traits::no_type assign_is_pair( ... );
84 #if BOOST_WORKAROUND(__BORLANDC__, BOOST_TESTED_AT(0x564))
86 char dummy_; // BCB would by default use 8 bytes
89 struct adapter_type_tag
91 #if BOOST_WORKAROUND(__BORLANDC__, BOOST_TESTED_AT(0x564))
93 char dummy_; // BCB would by default use 8 bytes
98 #if BOOST_WORKAROUND(__BORLANDC__, BOOST_TESTED_AT(0x564))
100 char dummy_; // BCB would by default use 8 bytes
103 struct default_type_tag
105 #if BOOST_WORKAROUND(__BORLANDC__, BOOST_TESTED_AT(0x564))
107 char dummy_; // BCB would by default use 8 bytes
113 template< class DerivedTAssign, class Iterator >
116 public: // Range operations
117 typedef Iterator iterator;
118 typedef Iterator const_iterator;
120 iterator begin() const
122 return static_cast<const DerivedTAssign*>(this)->begin();
127 return static_cast<const DerivedTAssign*>(this)->end();
132 template< class Container >
133 Container convert_to_container() const
135 static Container* c = 0;
136 BOOST_STATIC_CONSTANT( bool, is_array_flag = sizeof( assign_detail::assign_is_array( c ) )
137 == sizeof( type_traits::yes_type ) );
139 typedef BOOST_DEDUCED_TYPENAME mpl::if_c< is_array_flag,
141 default_type_tag >::type tag_type;
143 return convert<Container>( c, tag_type() );
148 template< class Container >
149 Container convert( const Container*, default_type_tag ) const
152 #if BOOST_WORKAROUND(BOOST_DINKUMWARE_STDLIB, == 1)
153 // old Dinkumware doesn't support iterator type as template
155 iterator it = begin(),
159 result.insert( result.end(), *it );
164 return Container( begin(), end() );
168 template< class Array >
169 Array convert( const Array*, array_type_tag ) const
171 typedef BOOST_DEDUCED_TYPENAME Array::value_type value_type;
173 #if BOOST_WORKAROUND(BOOST_INTEL, <= 910 ) || BOOST_WORKAROUND(__SUNPRO_CC, <= 0x580 )
174 BOOST_DEDUCED_TYPENAME remove_const<Array>::type ar;
178 const std::size_t sz = ar.size();
179 if( sz < static_cast<const DerivedTAssign*>(this)->size() )
180 BOOST_THROW_EXCEPTION( assign::assignment_exception( "array initialized with too many elements" ) );
182 iterator i = begin(),
184 for( ; i != e; ++i, ++n )
187 ar[n] = value_type();
191 template< class Adapter >
192 Adapter convert_to_adapter( const Adapter* = 0 ) const
195 iterator i = begin(),
203 struct adapter_converter;
204 friend struct adapter_converter;
206 struct adapter_converter
209 adapter_converter( const converter& this_ ) : gl( this_ )
212 adapter_converter( const adapter_converter& r )
216 template< class Adapter >
217 operator Adapter() const
219 return gl.convert_to_adapter<Adapter>();
224 template< class Container >
225 Container to_container( Container& c ) const
227 return convert( &c, default_type_tag() );
230 adapter_converter to_adapter() const
232 return adapter_converter( *this );
235 template< class Adapter >
236 Adapter to_adapter( Adapter& a ) const
238 return this->convert_to_adapter( &a );
241 template< class Array >
242 Array to_array( Array& a ) const
244 return convert( &a, array_type_tag() );
248 template< class T, class I, class Range >
249 inline bool operator==( const converter<T,I>& l, const Range& r )
251 return ::boost::iterator_range_detail::equal( l, r );
254 template< class T, class I, class Range >
255 inline bool operator==( const Range& l, const converter<T,I>& r )
260 template< class T, class I, class Range >
261 inline bool operator!=( const converter<T,I>& l, const Range& r )
266 template< class T, class I, class Range >
267 inline bool operator!=( const Range& l, const converter<T,I>& r )
272 template< class T, class I, class Range >
273 inline bool operator<( const converter<T,I>& l, const Range& r )
275 return ::boost::iterator_range_detail::less_than( l, r );
278 template< class T, class I, class Range >
279 inline bool operator<( const Range& l, const converter<T,I>& r )
281 return ::boost::iterator_range_detail::less_than( l, r );
284 template< class T, class I, class Range >
285 inline bool operator>( const converter<T,I>& l, const Range& r )
290 template< class T, class I, class Range >
291 inline bool operator>( const Range& l, const converter<T,I>& r )
296 template< class T, class I, class Range >
297 inline bool operator<=( const converter<T,I>& l, const Range& r )
302 template< class T, class I, class Range >
303 inline bool operator<=( const Range& l, const converter<T,I>& r )
308 template< class T, class I, class Range >
309 inline bool operator>=( const converter<T,I>& l, const Range& r )
314 template< class T, class I, class Range >
315 inline bool operator>=( const Range& l, const converter<T,I>& r )
320 template< class T, class I, class Elem, class Traits >
321 inline std::basic_ostream<Elem,Traits>&
322 operator<<( std::basic_ostream<Elem, Traits>& Os,
323 const converter<T,I>& r )
325 return Os << ::boost::make_iterator_range( r.begin(), r.end() );
328 /////////////////////////////////////////////////////////////////////////
329 // Part 1: flexible, but inefficient interface
330 /////////////////////////////////////////////////////////////////////////
334 public converter< generic_list< BOOST_DEDUCED_TYPENAME assign_decay<T>::type >,
335 BOOST_DEDUCED_TYPENAME std::deque<BOOST_DEDUCED_TYPENAME
336 assign_decay<T>::type>::iterator >
338 typedef BOOST_DEDUCED_TYPENAME assign_decay<T>::type Ty;
339 typedef std::deque<Ty> impl_type;
340 mutable impl_type values_;
343 typedef BOOST_DEDUCED_TYPENAME impl_type::iterator iterator;
344 typedef iterator const_iterator;
345 typedef BOOST_DEDUCED_TYPENAME impl_type::value_type value_type;
346 typedef BOOST_DEDUCED_TYPENAME impl_type::size_type size_type;
347 typedef BOOST_DEDUCED_TYPENAME impl_type::difference_type difference_type;
350 iterator begin() const { return values_.begin(); }
351 iterator end() const { return values_.end(); }
352 bool empty() const { return values_.empty(); }
353 size_type size() const { return values_.size(); }
356 void push_back( value_type r ) { values_.push_back( r ); }
359 generic_list& operator,( const Ty& u )
361 this->push_back( u );
365 generic_list& operator()()
367 this->push_back( Ty() );
371 generic_list& operator()( const Ty& u )
373 this->push_back( u );
378 #ifndef BOOST_ASSIGN_MAX_PARAMS // use user's value
379 #define BOOST_ASSIGN_MAX_PARAMS 5
381 #define BOOST_ASSIGN_MAX_PARAMETERS (BOOST_ASSIGN_MAX_PARAMS - 1)
382 #define BOOST_ASSIGN_PARAMS1(n) BOOST_PP_ENUM_PARAMS(n, class U)
383 #define BOOST_ASSIGN_PARAMS2(n) BOOST_PP_ENUM_BINARY_PARAMS(n, U, const& u)
384 #define BOOST_ASSIGN_PARAMS3(n) BOOST_PP_ENUM_PARAMS(n, u)
385 #define BOOST_ASSIGN_PARAMS4(n) BOOST_PP_ENUM_PARAMS(n, U)
386 #define BOOST_ASSIGN_PARAMS2_NO_REF(n) BOOST_PP_ENUM_BINARY_PARAMS(n, U, u)
388 #define BOOST_PP_LOCAL_LIMITS (1, BOOST_ASSIGN_MAX_PARAMETERS)
389 #define BOOST_PP_LOCAL_MACRO(n) \
390 template< class U, BOOST_ASSIGN_PARAMS1(n) > \
391 generic_list& operator()(U const& u, BOOST_ASSIGN_PARAMS2(n) ) \
393 this->push_back( Ty(u, BOOST_ASSIGN_PARAMS3(n))); \
398 #include BOOST_PP_LOCAL_ITERATE()
402 generic_list& repeat( std::size_t sz, U u )
406 this->push_back( u );
410 template< class Nullary_function >
411 generic_list& repeat_fun( std::size_t sz, Nullary_function fun )
415 this->push_back( fun() );
419 template< class SinglePassIterator >
420 generic_list& range( SinglePassIterator first,
421 SinglePassIterator last )
423 for( ; first != last; ++first )
424 this->push_back( *first );
428 template< class SinglePassRange >
429 generic_list& range( const SinglePassRange& r )
431 return range( boost::begin(r), boost::end(r) );
434 template< class Container >
435 operator Container() const
437 return this-> BOOST_NESTED_TEMPLATE convert_to_container<Container>();
441 /////////////////////////////////////////////////////////////////////////
442 // Part 2: efficient, but inconvenient interface
443 /////////////////////////////////////////////////////////////////////////
446 struct assign_reference
449 { /* intentionally empty */ }
451 assign_reference( T& r ) : ref_(&r)
454 void operator=( T& r )
464 void swap( assign_reference& r )
466 std::swap( *ref_, *r.ref_ );
480 inline bool operator<( const assign_reference<T>& l,
481 const assign_reference<T>& r )
483 return l.get_ref() < r.get_ref();
487 inline bool operator>( const assign_reference<T>& l,
488 const assign_reference<T>& r )
490 return l.get_ref() > r.get_ref();
494 inline void swap( assign_reference<T>& l,
495 assign_reference<T>& r )
502 template< class T, int N >
503 struct static_generic_list :
504 public converter< static_generic_list<T,N>, assign_reference<T>* >
507 typedef T internal_value_type;
510 typedef assign_reference<internal_value_type> value_type;
511 typedef value_type* iterator;
512 typedef value_type* const_iterator;
513 typedef std::size_t size_type;
514 typedef std::ptrdiff_t difference_type;
517 static_generic_list( T& r ) :
523 static_generic_list& operator()( T& r )
529 iterator begin() const
536 return &refs_[current_];
539 size_type size() const
541 return static_cast<size_type>( current_ );
549 template< class ForwardIterator >
550 static_generic_list& range( ForwardIterator first,
551 ForwardIterator last )
553 for( ; first != last; ++first )
554 this->insert( *first );
558 template< class ForwardRange >
559 static_generic_list& range( ForwardRange& r )
561 return range( boost::begin(r), boost::end(r) );
564 template< class ForwardRange >
565 static_generic_list& range( const ForwardRange& r )
567 return range( boost::begin(r), boost::end(r) );
570 template< class Container >
571 operator Container() const
573 return this-> BOOST_NESTED_TEMPLATE convert_to_container<Container>();
583 static_generic_list();
585 mutable assign_reference<internal_value_type> refs_[N];
589 } // namespace 'assign_detail'
594 inline assign_detail::generic_list<T>
597 return assign_detail::generic_list<T>()( T() );
601 inline assign_detail::generic_list<T>
602 list_of( const T& t )
604 return assign_detail::generic_list<T>()( t );
607 template< int N, class T >
608 inline assign_detail::static_generic_list< BOOST_DEDUCED_TYPENAME assign_detail::assign_decay<T>::type,N>
611 return assign_detail::static_generic_list<BOOST_DEDUCED_TYPENAME assign_detail::assign_decay<T>::type,N>( t );
614 template< int N, class T >
615 inline assign_detail::static_generic_list<const BOOST_DEDUCED_TYPENAME assign_detail::assign_decay<T>::type,N>
616 cref_list_of( const T& t )
618 return assign_detail::static_generic_list<const BOOST_DEDUCED_TYPENAME assign_detail::assign_decay<T>::type,N>( t );
621 #define BOOST_PP_LOCAL_LIMITS (1, BOOST_ASSIGN_MAX_PARAMETERS)
622 #define BOOST_PP_LOCAL_MACRO(n) \
623 template< class T, class U, BOOST_ASSIGN_PARAMS1(n) > \
624 inline assign_detail::generic_list<T> \
625 list_of(U const& u, BOOST_ASSIGN_PARAMS2(n) ) \
627 return assign_detail::generic_list<T>()(u, BOOST_ASSIGN_PARAMS3(n)); \
631 #include BOOST_PP_LOCAL_ITERATE()
633 #define BOOST_PP_LOCAL_LIMITS (1, BOOST_ASSIGN_MAX_PARAMETERS)
634 #define BOOST_PP_LOCAL_MACRO(n) \
635 template< class U, BOOST_ASSIGN_PARAMS1(n) > \
636 inline assign_detail::generic_list< tuple<U, BOOST_ASSIGN_PARAMS4(n)> > \
637 tuple_list_of(U u, BOOST_ASSIGN_PARAMS2_NO_REF(n) ) \
639 return assign_detail::generic_list< tuple<U, BOOST_ASSIGN_PARAMS4(n)> >()( tuple<U,BOOST_ASSIGN_PARAMS4(n)>( u, BOOST_ASSIGN_PARAMS3(n) )); \
643 #include BOOST_PP_LOCAL_ITERATE()
646 template< class Key, class T >
647 inline assign_detail::generic_list< std::pair
649 BOOST_DEDUCED_TYPENAME assign_detail::assign_decay<Key>::type,
650 BOOST_DEDUCED_TYPENAME assign_detail::assign_decay<T>::type
652 map_list_of( const Key& k, const T& t )
654 typedef BOOST_DEDUCED_TYPENAME assign_detail::assign_decay<Key>::type k_type;
655 typedef BOOST_DEDUCED_TYPENAME assign_detail::assign_decay<T>::type t_type;
656 return assign_detail::generic_list< std::pair<k_type,t_type> >()( k, t );
659 template< class F, class S >
660 inline assign_detail::generic_list< std::pair
662 BOOST_DEDUCED_TYPENAME assign_detail::assign_decay<F>::type,
663 BOOST_DEDUCED_TYPENAME assign_detail::assign_decay<S>::type
665 pair_list_of( const F& f, const S& s )
667 return map_list_of( f, s );
671 } // namespace 'assign'
672 } // namespace 'boost'
675 #undef BOOST_ASSIGN_PARAMS1
676 #undef BOOST_ASSIGN_PARAMS2
677 #undef BOOST_ASSIGN_PARAMS3
678 #undef BOOST_ASSIGN_PARAMS4
679 #undef BOOST_ASSIGN_PARAMS2_NO_REF
680 #undef BOOST_ASSIGN_MAX_PARAMETERS