// Class template uniform_int_distribution -*- C++ -*- // Copyright (C) 2009-2017 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the // terms of the GNU General Public License as published by the // Free Software Foundation; either version 3, or (at your option) // any later version. // This library is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // Under Section 7 of GPL version 3, you are granted additional // permissions described in the GCC Runtime Library Exception, version // 3.1, as published by the Free Software Foundation. // You should have received a copy of the GNU General Public License and // a copy of the GCC Runtime Library Exception along with this program; // see the files COPYING3 and COPYING.RUNTIME respectively. If not, see // <http://www.gnu.org/licenses/>. /** * @file bits/uniform_int_dist.h * This is an internal header file, included by other library headers. * Do not attempt to use it directly. @headername{random} */ #ifndef _GLIBCXX_BITS_UNIFORM_INT_DIST_H #define _GLIBCXX_BITS_UNIFORM_INT_DIST_H #include <type_traits> #include <limits> namespace std _GLIBCXX_VISIBILITY(default) { namespace __detail { _GLIBCXX_BEGIN_NAMESPACE_VERSION /* Determine whether number is a power of 2. */ template<typename _Tp> inline bool _Power_of_2(_Tp __x) { return ((__x - 1) & __x) == 0; }; _GLIBCXX_END_NAMESPACE_VERSION } _GLIBCXX_BEGIN_NAMESPACE_VERSION /** * @brief Uniform discrete distribution for random numbers. * A discrete random distribution on the range @f$[min, max]@f$ with equal * probability throughout the range. */ template<typename _IntType = int> class uniform_int_distribution { static_assert(std::is_integral<_IntType>::value, "template argument must be an integral type"); public: /** The type of the range of the distribution. */ typedef _IntType result_type; /** Parameter type. */ struct param_type { typedef uniform_int_distribution<_IntType> distribution_type; explicit param_type(_IntType __a = 0, _IntType __b = std::numeric_limits<_IntType>::max()) : _M_a(__a), _M_b(__b) { __glibcxx_assert(_M_a <= _M_b); } result_type a() const { return _M_a; } result_type b() const { return _M_b; } friend bool operator==(const param_type& __p1, const param_type& __p2) { return __p1._M_a == __p2._M_a && __p1._M_b == __p2._M_b; } friend bool operator!=(const param_type& __p1, const param_type& __p2) { return !(__p1 == __p2); } private: _IntType _M_a; _IntType _M_b; }; public: /** * @brief Constructs a uniform distribution object. */ explicit uniform_int_distribution(_IntType __a = 0, _IntType __b = std::numeric_limits<_IntType>::max()) : _M_param(__a, __b) { } explicit uniform_int_distribution(const param_type& __p) : _M_param(__p) { } /** * @brief Resets the distribution state. * * Does nothing for the uniform integer distribution. */ void reset() { } result_type a() const { return _M_param.a(); } result_type b() const { return _M_param.b(); } /** * @brief Returns the parameter set of the distribution. */ param_type param() const { return _M_param; } /** * @brief Sets the parameter set of the distribution. * @param __param The new parameter set of the distribution. */ void param(const param_type& __param) { _M_param = __param; } /** * @brief Returns the inclusive lower bound of the distribution range. */ result_type min() const { return this->a(); } /** * @brief Returns the inclusive upper bound of the distribution range. */ result_type max() const { return this->b(); } /** * @brief Generating functions. */ template<typename _UniformRandomNumberGenerator> result_type operator()(_UniformRandomNumberGenerator& __urng) { return this->operator()(__urng, _M_param); } template<typename _UniformRandomNumberGenerator> result_type operator()(_UniformRandomNumberGenerator& __urng, const param_type& __p); template<typename _ForwardIterator, typename _UniformRandomNumberGenerator> void __generate(_ForwardIterator __f, _ForwardIterator __t, _UniformRandomNumberGenerator& __urng) { this->__generate(__f, __t, __urng, _M_param); } template<typename _ForwardIterator, typename _UniformRandomNumberGenerator> void __generate(_ForwardIterator __f, _ForwardIterator __t, _UniformRandomNumberGenerator& __urng, const param_type& __p) { this->__generate_impl(__f, __t, __urng, __p); } template<typename _UniformRandomNumberGenerator> void __generate(result_type* __f, result_type* __t, _UniformRandomNumberGenerator& __urng, const param_type& __p) { this->__generate_impl(__f, __t, __urng, __p); } /** * @brief Return true if two uniform integer distributions have * the same parameters. */ friend bool operator==(const uniform_int_distribution& __d1, const uniform_int_distribution& __d2) { return __d1._M_param == __d2._M_param; } private: template<typename _ForwardIterator, typename _UniformRandomNumberGenerator> void __generate_impl(_ForwardIterator __f, _ForwardIterator __t, _UniformRandomNumberGenerator& __urng, const param_type& __p); param_type _M_param; }; template<typename _IntType> template<typename _UniformRandomNumberGenerator> typename uniform_int_distribution<_IntType>::result_type uniform_int_distribution<_IntType>:: operator()(_UniformRandomNumberGenerator& __urng, const param_type& __param) { typedef typename _UniformRandomNumberGenerator::result_type _Gresult_type; typedef typename std::make_unsigned<result_type>::type __utype; typedef typename std::common_type<_Gresult_type, __utype>::type __uctype; const __uctype __urngmin = __urng.min(); const __uctype __urngmax = __urng.max(); const __uctype __urngrange = __urngmax - __urngmin; const __uctype __urange = __uctype(__param.b()) - __uctype(__param.a()); __uctype __ret; if (__urngrange > __urange) { // downscaling const __uctype __uerange = __urange + 1; // __urange can be zero const __uctype __scaling = __urngrange / __uerange; const __uctype __past = __uerange * __scaling; do __ret = __uctype(__urng()) - __urngmin; while (__ret >= __past); __ret /= __scaling; } else if (__urngrange < __urange) { // upscaling /* Note that every value in [0, urange] can be written uniquely as (urngrange + 1) * high + low where high in [0, urange / (urngrange + 1)] and low in [0, urngrange]. */ __uctype __tmp; // wraparound control do { const __uctype __uerngrange = __urngrange + 1; __tmp = (__uerngrange * operator() (__urng, param_type(0, __urange / __uerngrange))); __ret = __tmp + (__uctype(__urng()) - __urngmin); } while (__ret > __urange || __ret < __tmp); } else __ret = __uctype(__urng()) - __urngmin; return __ret + __param.a(); } template<typename _IntType> template<typename _ForwardIterator, typename _UniformRandomNumberGenerator> void uniform_int_distribution<_IntType>:: __generate_impl(_ForwardIterator __f, _ForwardIterator __t, _UniformRandomNumberGenerator& __urng, const param_type& __param) { __glibcxx_function_requires(_ForwardIteratorConcept<_ForwardIterator>) typedef typename _UniformRandomNumberGenerator::result_type _Gresult_type; typedef typename std::make_unsigned<result_type>::type __utype; typedef typename std::common_type<_Gresult_type, __utype>::type __uctype; const __uctype __urngmin = __urng.min(); const __uctype __urngmax = __urng.max(); const __uctype __urngrange = __urngmax - __urngmin; const __uctype __urange = __uctype(__param.b()) - __uctype(__param.a()); __uctype __ret; if (__urngrange > __urange) { if (__detail::_Power_of_2(__urngrange + 1) && __detail::_Power_of_2(__urange + 1)) { while (__f != __t) { __ret = __uctype(__urng()) - __urngmin; *__f++ = (__ret & __urange) + __param.a(); } } else { // downscaling const __uctype __uerange = __urange + 1; // __urange can be zero const __uctype __scaling = __urngrange / __uerange; const __uctype __past = __uerange * __scaling; while (__f != __t) { do __ret = __uctype(__urng()) - __urngmin; while (__ret >= __past); *__f++ = __ret / __scaling + __param.a(); } } } else if (__urngrange < __urange) { // upscaling /* Note that every value in [0, urange] can be written uniquely as (urngrange + 1) * high + low where high in [0, urange / (urngrange + 1)] and low in [0, urngrange]. */ __uctype __tmp; // wraparound control while (__f != __t) { do { const __uctype __uerngrange = __urngrange + 1; __tmp = (__uerngrange * operator() (__urng, param_type(0, __urange / __uerngrange))); __ret = __tmp + (__uctype(__urng()) - __urngmin); } while (__ret > __urange || __ret < __tmp); *__f++ = __ret; } } else while (__f != __t) *__f++ = __uctype(__urng()) - __urngmin + __param.a(); } // operator!= and operator<< and operator>> are defined in <bits/random.h> _GLIBCXX_END_NAMESPACE_VERSION } // namespace std #endif
Name | Type | Size | Permission | Actions |
---|---|---|---|---|
algorithmfwd.h | File | 21.23 KB | 0644 |
|
alloc_traits.h | File | 19.13 KB | 0644 |
|
allocated_ptr.h | File | 3.43 KB | 0644 |
|
allocator.h | File | 6.73 KB | 0644 |
|
atomic_base.h | File | 23.28 KB | 0644 |
|
atomic_futex.h | File | 9.35 KB | 0644 |
|
atomic_lockfree_defines.h | File | 2.2 KB | 0644 |
|
basic_ios.h | File | 15.7 KB | 0644 |
|
basic_ios.tcc | File | 5.94 KB | 0644 |
|
basic_string.h | File | 235.15 KB | 0644 |
|
basic_string.tcc | File | 52.5 KB | 0644 |
|
boost_concept_check.h | File | 26.41 KB | 0644 |
|
c++0x_warning.h | File | 1.44 KB | 0644 |
|
char_traits.h | File | 20.26 KB | 0644 |
|
codecvt.h | File | 20.8 KB | 0644 |
|
concept_check.h | File | 3.34 KB | 0644 |
|
cpp_type_traits.h | File | 9.37 KB | 0644 |
|
cxxabi_forced.h | File | 1.77 KB | 0644 |
|
cxxabi_init_exception.h | File | 2.17 KB | 0644 |
|
deque.tcc | File | 33.26 KB | 0644 |
|
enable_special_members.h | File | 12.1 KB | 0644 |
|
exception.h | File | 2.23 KB | 0644 |
|
exception_defines.h | File | 1.61 KB | 0644 |
|
exception_ptr.h | File | 6.31 KB | 0644 |
|
forward_list.h | File | 47.5 KB | 0644 |
|
forward_list.tcc | File | 14.68 KB | 0644 |
|
fstream.tcc | File | 32.14 KB | 0644 |
|
functexcept.h | File | 3.18 KB | 0644 |
|
functional_hash.h | File | 8 KB | 0644 |
|
gslice.h | File | 5.39 KB | 0644 |
|
gslice_array.h | File | 7.59 KB | 0644 |
|
hash_bytes.h | File | 2.1 KB | 0644 |
|
hashtable.h | File | 71.56 KB | 0644 |
|
hashtable_policy.h | File | 65.47 KB | 0644 |
|
indirect_array.h | File | 7.68 KB | 0644 |
|
invoke.h | File | 3.57 KB | 0644 |
|
ios_base.h | File | 30.22 KB | 0644 |
|
istream.tcc | File | 30.36 KB | 0644 |
|
list.tcc | File | 15.54 KB | 0644 |
|
locale_classes.h | File | 24.31 KB | 0644 |
|
locale_classes.tcc | File | 8.18 KB | 0644 |
|
locale_conv.h | File | 15.7 KB | 0644 |
|
locale_facets.h | File | 89.98 KB | 0644 |
|
locale_facets.tcc | File | 38.64 KB | 0644 |
|
locale_facets_nonio.h | File | 67.33 KB | 0644 |
|
locale_facets_nonio.tcc | File | 44.46 KB | 0644 |
|
localefwd.h | File | 5.51 KB | 0644 |
|
mask_array.h | File | 7.42 KB | 0644 |
|
memoryfwd.h | File | 2.36 KB | 0644 |
|
move.h | File | 6.5 KB | 0644 |
|
nested_exception.h | File | 4.66 KB | 0644 |
|
node_handle.h | File | 7.97 KB | 0644 |
|
ostream.tcc | File | 12.03 KB | 0644 |
|
ostream_insert.h | File | 3.91 KB | 0644 |
|
parse_numbers.h | File | 7.84 KB | 0644 |
|
postypes.h | File | 8.02 KB | 0644 |
|
predefined_ops.h | File | 8.87 KB | 0644 |
|
ptr_traits.h | File | 4.75 KB | 0644 |
|
quoted_string.h | File | 4.47 KB | 0644 |
|
random.h | File | 171.19 KB | 0644 |
|
random.tcc | File | 103.08 KB | 0644 |
|
range_access.h | File | 9.75 KB | 0644 |
|
refwrap.h | File | 13.48 KB | 0644 |
|
regex.h | File | 95.9 KB | 0644 |
|
regex.tcc | File | 16.1 KB | 0644 |
|
regex_automaton.h | File | 10.47 KB | 0644 |
|
regex_automaton.tcc | File | 7.65 KB | 0644 |
|
regex_compiler.h | File | 16.79 KB | 0644 |
|
regex_compiler.tcc | File | 18.46 KB | 0644 |
|
regex_constants.h | File | 14.36 KB | 0644 |
|
regex_error.h | File | 4.85 KB | 0644 |
|
regex_executor.h | File | 7.31 KB | 0644 |
|
regex_executor.tcc | File | 16.91 KB | 0644 |
|
regex_scanner.h | File | 6.92 KB | 0644 |
|
regex_scanner.tcc | File | 14.66 KB | 0644 |
|
shared_ptr.h | File | 22.37 KB | 0644 |
|
shared_ptr_atomic.h | File | 9.54 KB | 0644 |
|
shared_ptr_base.h | File | 52.54 KB | 0644 |
|
slice_array.h | File | 9.13 KB | 0644 |
|
specfun.h | File | 44.03 KB | 0644 |
|
sstream.tcc | File | 9.88 KB | 0644 |
|
std_abs.h | File | 3.21 KB | 0644 |
|
std_function.h | File | 23.41 KB | 0644 |
|
std_mutex.h | File | 9.08 KB | 0644 |
|
stl_algo.h | File | 208.85 KB | 0644 |
|
stl_algobase.h | File | 49.22 KB | 0644 |
|
stl_bvector.h | File | 33.03 KB | 0644 |
|
stl_construct.h | File | 7.22 KB | 0644 |
|
stl_deque.h | File | 75.95 KB | 0644 |
|
stl_function.h | File | 32.5 KB | 0644 |
|
stl_heap.h | File | 19.73 KB | 0644 |
|
stl_iterator.h | File | 40.77 KB | 0644 |
|
stl_iterator_base_funcs.h | File | 7.88 KB | 0644 |
|
stl_iterator_base_types.h | File | 8.48 KB | 0644 |
|
stl_list.h | File | 63.65 KB | 0644 |
|
stl_map.h | File | 50.02 KB | 0644 |
|
stl_multimap.h | File | 39 KB | 0644 |
|
stl_multiset.h | File | 33.26 KB | 0644 |
|
stl_numeric.h | File | 13.51 KB | 0644 |
|
stl_pair.h | File | 18.21 KB | 0644 |
|
stl_queue.h | File | 21.61 KB | 0644 |
|
stl_raw_storage_iter.h | File | 3.74 KB | 0644 |
|
stl_relops.h | File | 4.49 KB | 0644 |
|
stl_set.h | File | 33.63 KB | 0644 |
|
stl_stack.h | File | 11.18 KB | 0644 |
|
stl_tempbuf.h | File | 8.15 KB | 0644 |
|
stl_tree.h | File | 73.07 KB | 0644 |
|
stl_uninitialized.h | File | 27 KB | 0644 |
|
stl_vector.h | File | 54.33 KB | 0644 |
|
stream_iterator.h | File | 6.5 KB | 0644 |
|
streambuf.tcc | File | 4.81 KB | 0644 |
|
streambuf_iterator.h | File | 12.33 KB | 0644 |
|
string_view.tcc | File | 6.48 KB | 0644 |
|
stringfwd.h | File | 2.55 KB | 0644 |
|
uniform_int_dist.h | File | 9.91 KB | 0644 |
|
unique_ptr.h | File | 24.88 KB | 0644 |
|
unordered_map.h | File | 67.04 KB | 0644 |
|
unordered_set.h | File | 52.56 KB | 0644 |
|
uses_allocator.h | File | 6.23 KB | 0644 |
|
valarray_after.h | File | 22.12 KB | 0644 |
|
valarray_array.h | File | 21.3 KB | 0644 |
|
valarray_array.tcc | File | 7.08 KB | 0644 |
|
valarray_before.h | File | 18.08 KB | 0644 |
|
vector.tcc | File | 26.95 KB | 0644 |
|