ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: opt / cpanel / ea-ruby27 / src / passenger-release-6.1.2 / src / cxx_supportlib / vendor-modified / boost / random

/* boost random/variate_generator.hpp header file
 *
 * Copyright Jens Maurer 2002
 * Copyright Steven Watanabe 2011
 * Distributed under 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)
 *
 * See http://www.boost.org for most recent version including documentation.
 *
 * $Id$
 *
 */

#ifndef BOOST_RANDOM_RANDOM_GENERATOR_HPP
#define BOOST_RANDOM_RANDOM_GENERATOR_HPP

#include <boost/random/detail/ptr_helper.hpp>

#include <boost/random/detail/disable_warnings.hpp>

namespace boost {

/// \cond hide_private_members

namespace random {

///\endcond

/**
 * A random variate generator is used to join a random number
 * generator together with a random number distribution.
 * Boost.Random provides a vast choice of \generators as well
 * as \distributions.
 *
 * The argument for the template parameter Engine shall be of
 * the form U, U&, or U*, where U models a
 * \uniform_random_number_generator.  Then, the member
 * engine_value_type names U (not the pointer or reference to U).
 *
 * Specializations of @c variate_generator satisfy the
 * requirements of CopyConstructible. They also satisfy the
 * requirements of Assignable unless the template parameter
 * Engine is of the form U&.
 *
 * The complexity of all functions specified in this section
 * is constant. No function described in this section except
 * the constructor throws an exception.
 */
template<class Engine, class Distribution>
class variate_generator
{
private:
    typedef boost::random::detail::ptr_helper<Engine> helper_type;
public:
    typedef typename helper_type::value_type engine_value_type;
    typedef Engine engine_type;
    typedef Distribution distribution_type;
    typedef typename Distribution::result_type result_type;

/**
     * Constructs a @c variate_generator object with the associated
     * \uniform_random_number_generator eng and the associated
     * \random_distribution d.
     *
     * Throws: If and what the copy constructor of Engine or
     * Distribution throws.
     */
    variate_generator(Engine e, Distribution d)
      : _eng(e), _dist(d) { }

/** Returns: distribution()(engine()) */
    result_type operator()() { return _dist(engine()); }
    /**
     * Returns: distribution()(engine(), value).
     */
    template<class T>
    result_type operator()(const T& value) { return _dist(engine(), value); }

/**
     * Returns: A reference to the associated uniform random number generator.
     */
    engine_value_type& engine() { return helper_type::ref(_eng); }
    /**
     * Returns: A reference to the associated uniform random number generator.
     */
    const engine_value_type& engine() const { return helper_type::ref(_eng); }

/** Returns: A reference to the associated \random_distribution. */
    distribution_type& distribution() { return _dist; }
    /**
     * Returns: A reference to the associated random distribution.
     */
    const distribution_type& distribution() const { return _dist; }

/**
     * Precondition: distribution().min() is well-formed
     *
     * Returns: distribution().min()
     */
    result_type min BOOST_PREVENT_MACRO_SUBSTITUTION () const { return (distribution().min)(); }
    /**
     * Precondition: distribution().max() is well-formed
     *
     * Returns: distribution().max()
     */
    result_type max BOOST_PREVENT_MACRO_SUBSTITUTION () const { return (distribution().max)(); }

private:
    Engine _eng;
    distribution_type _dist;
};

} // namespace random

using random::variate_generator;

} // namespace boost

#include <boost/random/detail/enable_warnings.hpp>

#endif // BOOST_RANDOM_RANDOM_GENERATOR_HPP

[-] uniform_smallint.hpp [edit]
[-] weibull_distribution.hpp [edit]
[-] xor_combine.hpp [edit]
[-] generate_canonical.hpp [edit]
[-] traits.hpp [edit]
[-] laplace_distribution.hpp [edit]
[-] hyperexponential_distribution.hpp [edit]
[-] student_t_distribution.hpp [edit]
[-] lagged_fibonacci.hpp [edit]
[-] uniform_int.hpp [edit]
[-] binomial_distribution.hpp [edit]
[-] uniform_on_sphere.hpp [edit]
[-] bernoulli_distribution.hpp [edit]
[-] triangle_distribution.hpp [edit]
[-] beta_distribution.hpp [edit]
[-] subtract_with_carry.hpp [edit]
[-] uniform_01.hpp [edit]
[-] discrete_distribution.hpp [edit]
[-] variate_generator.hpp [edit]
[-] taus88.hpp [edit]
[-] generalized_inverse_gaussian_distribution.hpp [edit]
[-] random_number_generator.hpp [edit]
[-] exponential_distribution.hpp [edit]
[+] ..
[-] inverse_gaussian_distribution.hpp [edit]
[-] xoshiro.hpp [edit]
[-] inversive_congruential.hpp [edit]
[-] cauchy_distribution.hpp [edit]
[-] faure.hpp [edit]
[-] chi_squared_distribution.hpp [edit]
[-] linear_congruential.hpp [edit]
[-] mersenne_twister.hpp [edit]
[-] lognormal_distribution.hpp [edit]
[-] uniform_int_distribution.hpp [edit]
[-] geometric_distribution.hpp [edit]
[-] piecewise_linear_distribution.hpp [edit]
[-] independent_bits.hpp [edit]
[-] extreme_value_distribution.hpp [edit]
[-] splitmix64.hpp [edit]
[-] gamma_distribution.hpp [edit]
[-] niederreiter_base2.hpp [edit]
[-] poisson_distribution.hpp [edit]
[-] mixmax.hpp [edit]
[-] uniform_real_distribution.hpp [edit]
[-] discard_block.hpp [edit]
[-] seed_seq.hpp [edit]
[-] normal_distribution.hpp [edit]
[-] fisher_f_distribution.hpp [edit]
[-] negative_binomial_distribution.hpp [edit]
[-] shuffle_output.hpp [edit]
[-] linear_feedback_shift.hpp [edit]
[-] additive_combine.hpp [edit]
[+] detail
[-] shuffle_order.hpp [edit]
[-] random_device.hpp [edit]
[-] sobol.hpp [edit]
[-] ranlux.hpp [edit]
[-] uniform_real.hpp [edit]
[-] non_central_chi_squared_distribution.hpp [edit]
[-] piecewise_constant_distribution.hpp [edit]