1 // Copyright Neil Groves 2009. Use, modification and
2 // distribution is subject to the Boost Software License, Version
3 // 1.0. (See accompanying file LICENSE_1_0.txt or copy at
4 // http://www.boost.org/LICENSE_1_0.txt)
7 // For more information, see http://www.boost.org/libs/range/
9 #ifndef BOOST_RANGE_ALGORITHM_FIND_HPP_INCLUDED
10 #define BOOST_RANGE_ALGORITHM_FIND_HPP_INCLUDED
12 #include <boost/concept_check.hpp>
13 #include <boost/range/begin.hpp>
14 #include <boost/range/end.hpp>
15 #include <boost/range/concepts.hpp>
16 #include <boost/range/detail/range_return.hpp>
24 /// \brief template function find
26 /// range-based version of the find std algorithm
28 /// \pre SinglePassRange is a model of the SinglePassRangeConcept
29 template< class SinglePassRange, class Value >
30 inline BOOST_DEDUCED_TYPENAME disable_if<
31 is_const<SinglePassRange>,
32 BOOST_DEDUCED_TYPENAME range_iterator<SinglePassRange>::type
34 find( SinglePassRange& rng, const Value& val )
36 BOOST_RANGE_CONCEPT_ASSERT(( SinglePassRangeConcept<SinglePassRange> ));
37 return std::find(boost::begin(rng), boost::end(rng), val);
41 template< class SinglePassRange, class Value >
42 inline BOOST_DEDUCED_TYPENAME range_iterator<const SinglePassRange>::type
43 find( const SinglePassRange& rng, const Value& val )
45 BOOST_RANGE_CONCEPT_ASSERT(( SinglePassRangeConcept<const SinglePassRange> ));
46 return std::find(boost::begin(rng), boost::end(rng), val);
49 // range_return overloads
52 template< range_return_value re, class SinglePassRange, class Value >
53 inline BOOST_DEDUCED_TYPENAME disable_if<
54 is_const<SinglePassRange>,
55 BOOST_DEDUCED_TYPENAME range_return<SinglePassRange,re>::type
57 find( SinglePassRange& rng, const Value& val )
59 BOOST_RANGE_CONCEPT_ASSERT(( SinglePassRangeConcept<SinglePassRange> ));
60 return range_return<SinglePassRange,re>::
61 pack(std::find(boost::begin(rng), boost::end(rng), val),
66 template< range_return_value re, class SinglePassRange, class Value >
67 inline BOOST_DEDUCED_TYPENAME range_return<const SinglePassRange,re>::type
68 find( const SinglePassRange& rng, const Value& val )
70 BOOST_RANGE_CONCEPT_ASSERT(( SinglePassRangeConcept<const SinglePassRange> ));
71 return range_return<const SinglePassRange,re>::
72 pack(std::find(boost::begin(rng), boost::end(rng), val),
80 #endif // include guard