Boost.RangeEx merged into Boost.Range

[SVN r60897]

include/boost/range/algorithm/random_shuffle.hpp

@@ -0,0 +1,62 @@
+//  Copyright Neil Groves 2009. Use, modification and
+//  distribution is subject to the Boost Software License, Version
+//  1.0. (See accompanying file LICENSE_1_0.txt or copy at
+//  http://www.boost.org/LICENSE_1_0.txt)
+//
+//
+// For more information, see http://www.boost.org/libs/range/
+//
+#ifndef BOOST_RANGE_ALGORITHM_RANDOM_SHUFFLE_HPP_INCLUDED
+#define BOOST_RANGE_ALGORITHM_RANDOM_SHUFFLE_HPP_INCLUDED
+
+#include <boost/concept_check.hpp>
+#include <boost/range/begin.hpp>
+#include <boost/range/end.hpp>
+#include <boost/range/concepts.hpp>
+#include <algorithm>
+
+namespace boost
+{
+    /// \brief template function random_shuffle
+    ///
+    /// range-based version of the random_shuffle std algorithm
+    ///
+    /// \pre RandomAccessRange is a model of the RandomAccessRangeConcept
+    /// \pre Generator is a model of the UnaryFunctionConcept
+    template<class RandomAccessRange>
+    inline RandomAccessRange& random_shuffle(RandomAccessRange& rng)
+    {
+        boost::function_requires< RandomAccessRangeConcept<RandomAccessRange> >();
+        std::random_shuffle(boost::begin(rng), boost::end(rng));
+        return rng;
+    }
+
+    /// \overload
+    template<class RandomAccessRange>
+    inline const RandomAccessRange& random_shuffle(const RandomAccessRange& rng)
+    {
+        boost::function_requires< RandomAccessRangeConcept<RandomAccessRange> >();
+        std::random_shuffle(boost::begin(rng),boost::end(rng));
+        return rng;
+    }
+
+    /// \overload
+    template<class RandomAccessRange, class Generator>
+    inline RandomAccessRange& random_shuffle(RandomAccessRange& rng, Generator& gen)
+    {
+        boost::function_requires< RandomAccessRangeConcept<RandomAccessRange> >();
+        std::random_shuffle(boost::begin(rng), boost::end(rng), gen);
+        return rng;
+    }
+
+    /// \overload
+    template<class RandomAccessRange, class Generator>
+    inline const RandomAccessRange& random_shuffle(const RandomAccessRange& rng, Generator& gen)
+    {
+        boost::function_requires< RandomAccessRangeConcept<RandomAccessRange> >();
+        std::random_shuffle(boost::begin(rng), boost::end(rng), gen);
+        return rng;
+    }
+}
+
+#endif // include guard