Class template additive_combine_engine

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

Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. — Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

Class template additive_combine_engine

boost::random::additive_combine_engine

Synopsis

// In header: <boost/random/additive_combine.hpp>
template<typename MLCG1, typename MLCG2> 
class additive_combine_engine {
public:
  // types
  typedef MLCG1              first_base; 
  typedef MLCG2              second_base;
  typedef MLCG1::result_type result_type;
  // construct/copy/destruct
  additive_combine_engine();
  explicit additive_combine_engine(result_type);
  template<typename SeedSeq> explicit additive_combine_engine(SeedSeq &);
  additive_combine_engine(typename MLCG1::result_type, 
                          typename MLCG2::result_type);
  template<typename It> additive_combine_engine(It &, It);
  // public static functions
  static result_type min();
  static result_type max();
  // public member functions
  void seed();
  void seed(result_type);
  template<typename SeedSeq> void seed(SeedSeq &);
  void seed(typename MLCG1::result_type, typename MLCG2::result_type);
  template<typename It> void seed(It &, It);
  result_type operator()();
  template<typename Iter> void generate(Iter, Iter);
  void discard(boost::uintmax_t);
  // friend functions
  template<typename CharT, typename Traits> 
    friend std::basic_ostream< CharT, Traits > & 
    operator<<(std::basic_ostream< CharT, Traits > &, 
               const additive_combine_engine &);
  template<typename CharT, typename Traits> 
    friend std::basic_istream< CharT, Traits > & 
    operator>>(std::basic_istream< CharT, Traits > &, 
               const additive_combine_engine &);
  friend bool operator==(const additive_combine_engine &, 
                         const additive_combine_engine &);
  friend bool operator!=(const additive_combine_engine &, 
                         const additive_combine_engine &);
  // public data members
  static const bool has_fixed_range;
};

Description

Моделирование шаблона класса additive_combine_engine модели pseudo-случайного генератора чисел. Он объединяет два мультипликативных линейных_конгруэнциальных_двигателя генераторов чисел, т.е. тех, у которых c = Описывается в

"Efficient and Portable Combined Random Number Generators", Pierre L'Ecuyer, Communications of the ACM, Vol. 31, No. 6, June 1988, pp

Параметры шаблонов MLCG1 и MLCG2 должны обозначать два разных генератора чисел linear_congruential_engine, каждый с c = 0. Каждый вызов возвращает случайное число X(n) := (MLCG1(n) - MLCG2(n)) мод (m1 - 1), где m1 обозначает модуль MLCG1.

`additive_combine_engine` public construct/copy/destruct

```
additive_combine_engine();
```
Создает additive_combine_engine с использованием конструкторов по умолчанию двух базовых генераторов.
```
explicit additive_combine_engine(result_type seed);
```
Строит additive_combine_engine, используя семя в качестве аргумента конструктора для обоих генераторов базы.

templatetypename SeedSeq>explicitadditive_combine_engine& seq;

additive_combine_engine

Семантика этой функции подвержена изменениям. A seed_seq предназначен для генерации всех семян в одном кадре, но это семена двух базовых двигателей независимо и, вероятно, в конечном итоге дает одинаковую последовательность для обоих.

additive_combine_engine(typenameresult_type5>,typename MLCG2::result_type seed2;

additive_combine_engine, используя seed1 и seed2 в качестве аргумента конструктора для первого и второго генераторов оснований, соответственно.

templatetypename It>additive_combine_engine& first,It Last;

Конструкция additive_combine_engine со значениями из диапазона, определенного входными итераторами первый и последний. Сначала будет изменено указание на элемент после последнего использования.

Броски: std::invalid_argument, если входной диапазон слишком мал.

Безопасность исключения: Базовый

`additive_combine_engine` public static functions

```
static result_typemin();
```
Возвращает наименьшее значение, которое может произвести генератор
```
static result_typemax();
```
Возвращает наибольшее значение, которое может произвести генератор

`additive_combine_engine` public member functions

```
void seed();
```
Семена additive_combine_engine с использованием семян по умолчанию двух генераторов оснований.
```
void seed(result_type seed);
```
Семена additive_combine_engine, используя seed в качестве семени для обоих генераторов оснований.
```
templatetypename SeedSeq> voidseedSeedSeq & seq;
```
Семена additive_combine_engine, использующие seq для семенообразования обоих базовых генераторов.
См. предупреждение на соответствующем конструкторе.


voidseed(typenameresult_type::typename MLCG2::result_type seed2);
Семена additive_combine, используя seed1 и seed2 в качестве семян для первого и второго генераторов оснований, соответственно. 

templatetypename It> voidseedIt & first,It Last;
Семена additive_combine_engine со значениями из диапазона, определенного входными итераторами первый и последний. Сначала будет изменено указание на элемент после последнего использования.
  Броски: std::invalid_argument, если входной диапазон слишком мал.
 Безопасность исключения: Базовый 

result_type оператор();
Вернет следующее значение генератора. 

templatetypename Iter> voidgenerate(Iter first, Iter last;
  Заполняет диапазон случайными значениями 

void discard(boost::uintmax_t z);
  Улучшает состояние генератора на z.



additive_combine_engine friend functions


templatetypename CharT,TraitsBasic_ostream>,>оператор::Basic_ostream> >os,constcombine_enginecombine_engine
 до std::ostream. Текстовое представление additive_combine_engine представляет собой текстовое представление первого генератора оснований, за которым следует текстовое представление второго генератора оснований.

templatetypename CharT,Traitsbasic_istream> > оператор::basic_istream>  >>constcombine_enginecombine_enginecombine_engine
 из combine_engine:73>std::istream

:2>

```
friend boolоператор(constadditive_combine_engine , constadditive_combine_engine &;;
```
Возврат: истинно, что два additive_combine_engines будут производить одну и ту же последовательность значений.
```
friend boolоператор!=constadditive_combine_engine, constadditive_combine_engine,  constadditive_combine_engine & rhs;
```
Возврат: истинно, что два additive_combine_engines будут производить различные последовательности значений.

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

Материалы статей собраны из открытых источников, владелец сайта не претендует на авторство. Там где авторство установить не удалось, материал подаётся без имени автора. В случае если Вы считаете, что Ваши права нарушены, пожалуйста, свяжитесь с владельцем сайта.

:: Главная :: Reference ::

Время компиляции файла: 2024-08-30 11:47:00
2025-05-19 18:43:37/0.0077459812164307/0

Class template additive_combine_engine

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

Boost C++ Libraries

Class template additive_combine_engine

Synopsis

Description

additive_combine_engine public construct/copy/destruct

additive_combine_engine public static functions

additive_combine_engine public member functions

additive_combine_engine friend functions

`additive_combine_engine` public construct/copy/destruct

`additive_combine_engine` public static functions

`additive_combine_engine` public member functions

`additive_combine_engine` friend functions