Class template lagged_fibonacci_01_engine . Boost , The Boost C++ Libraries BoostBook Documentation Subset , Reference

Class template lagged_fibonacci_01_engine

boost::random::lagged_fibonacci_01_engine

Synopsis

// In header: <boost/random/lagged_fibonacci.hpp>
template<typename RealType, int w, unsigned int p, unsigned int q> 
class lagged_fibonacci_01_engine {
public:
  // types
  typedef RealType result_type;
  // construct/copy/destruct
  lagged_fibonacci_01_engine();
  explicit lagged_fibonacci_01_engine(uint32_t);
  template<typename SeedSeq> explicit lagged_fibonacci_01_engine(SeedSeq &);
  template<typename It> lagged_fibonacci_01_engine(It &, It);
  // public member functions
  void seed();
  void seed(boost::uint32_t);
  template<typename SeedSeq> void seed(SeedSeq &);
  template<typename It> void seed(It &, It);
  result_type operator()();
  template<typename Iter> void generate(Iter, Iter);
  void discard(boost::uintmax_t);
  // public static functions
  static result_type min();
  static result_type max();
  // friend functions
  template<typename CharT, typename Traits> 
    friend std::basic_ostream< CharT, Traits > & 
    operator<<(std::basic_ostream< CharT, Traits > &, 
               const lagged_fibonacci_01_engine &);
  template<typename CharT, typename Traits> 
    friend std::basic_istream< CharT, Traits > & 
    operator>>(std::basic_istream< CharT, Traits > &, 
               const lagged_fibonacci_01_engine &);
  friend bool operator==(const lagged_fibonacci_01_engine &, 
                         const lagged_fibonacci_01_engine &);
  friend bool operator!=(const lagged_fibonacci_01_engine &, 
                         const lagged_fibonacci_01_engine &);
  // public data members
  static const bool has_fixed_range;
  static const int word_size;
  static const unsigned int long_lag;
  static const unsigned int short_lag;
  static const boost::uint32_t default_seed;
};

Description

Обоснование шаблона класса<lagged_fibonacci_01>модельгенератор псевдослучайных чисел. Он использует алгоритм Фибоначчи с двумя лагами<p>и<q>, оцененными в арифметике с плавающей точкой: x(i) = x(i-p) + x(i-q) (mod 1) с p >q.

"Uniform random number generators for supercomputers", Richard Brent, Proc. of Fifth Australian Supercomputer Conference, Melbourne, Dec. 1992, pp.

	Note
	Качество генератора в решающей степени зависит от выбора параметров. Пользовательский код должен использовать один из разумно параметризованных генераторов, таких какlagged_fibonacci607вместо этого.

Генератор требует значительных объемов памяти для хранения своего массива состояний. Например,lagged_fibonacci607требует около 4856 байт иlagged_fibonacci44497требует около 350 Кбайт.

`lagged_fibonacci_01_engine` public construct/copy/destruct

<
```
lagged_fibonacci_01_engine();
```
>
Конструирует генератор<lagged_fibonacci_01>и вызывает<seed()>
.
<
```
explicitlagged_fibonacci_01_engine(uint32_tvalue);
```
>
Конструирует генератор<lagged_fibonacci_01>и вызывает<seed(value)>
.
<
```
template<typenameSeedSeq>explicitlagged_fibonacci_01_engine(SeedSeq&seq);
```
>
Конструирует генератор<lagged_fibonacci_01>и вызывает<seed(gen)>
.

template<typenameIt>lagged_fibonacci_01_engine(It&first,Itlast);

`lagged_fibonacci_01_engine` public member functions

<
```
voidseed();
```
>
Зов семян (по умолчанию_семена).
<
```
voidseed(boost::uint32_tvalue);
```
>
Постраивает генератор<minstd_rand0>со значением параметра конструктора и вызывает семя с ним. Отличительные семена в диапазоне [1, 2147483647] будут производить генераторы с различными состояниями. Другие семена будут эквивалентны некоторым семенам в этом диапазоне.<linear_congruential_engine>Подробности.
<
```
template<typenameSeedSeq>voidseed(SeedSeq&seq);
```
>
Семена<lagged_fibonacci_01_engine>с использованием значений, полученных<seq.generate>
.
<
```
template<typenameIt>voidseed(It&first,Itlast);
```
>
Семена это<lagged_fibonacci_01_engine>с использованием значений из диапазона итератора [первый, последний]. Если в ассортименте недостаточно элементов, бросает<std::invalid_argument>.
<
```
result_typeoperator()();
```
>
Возвращает следующее значение генератора.
<
```
template<typenameIter>voidgenerate(Iterfirst,Iterlast);
```
>
Заполняет диапазон случайными значениями
<
```
voiddiscard(boost::uintmax_tz);
```
>
Улучшает состояние генератора<z>
.

`lagged_fibonacci_01_engine` public static functions

<
```
staticresult_typemin();
```
>
Возвращает наименьшее значение, которое может произвести генератор.
<
```
staticresult_typemax();
```
>
Возвращает верхнюю границу выходов генераторов.

`lagged_fibonacci_01_engine` friend functions

template<typenameCharT,typenameTraits>
 friendstd::basic_ostream<CharT,Traits>&
 operator<<(std::basic_ostream<CharT,Traits>&os,
            constlagged_fibonacci_01_engine&f);

Текстовое представление генератора записывается в<std::ostream>

template<typenameCharT,typenameTraits>
 friendstd::basic_istream<CharT,Traits>&
 operator>>(std::basic_istream<CharT,Traits>&is,
            constlagged_fibonacci_01_engine&f);

Читает текстовое представление генератора из<std::istream>

<
```
friendbooloperator==(constlagged_fibonacci_01_engine&x_,
                      constlagged_fibonacci_01_engine&y_);
```
>
Возвращается истинно, если два генератора будут производить одинаковые последовательности выходов.
<
```
friendbooloperator!=(constlagged_fibonacci_01_engine&lhs,
                      constlagged_fibonacci_01_engine&rhs);
```
>
Возвращается истинно, если два генератора будут производить разные последовательности выходов.

Статья Class template lagged_fibonacci_01_engine раздела The Boost C++ Libraries BoostBook Documentation Subset Reference может быть полезна для разработчиков на c++ и boost.

Class template lagged_fibonacci_01_engine

Boost , The Boost C++ Libraries BoostBook Documentation Subset , Reference

Boost C++ Libraries

Class template lagged_fibonacci_01_engine

Synopsis

Description

lagged_fibonacci_01_engine public construct/copy/destruct

lagged_fibonacci_01_engine public member functions

lagged_fibonacci_01_engine public static functions

lagged_fibonacci_01_engine friend functions

`lagged_fibonacci_01_engine` public construct/copy/destruct

`lagged_fibonacci_01_engine` public member functions

`lagged_fibonacci_01_engine` public static functions

`lagged_fibonacci_01_engine` friend functions