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

Class template subtract_with_carry_engine

boost::random::subtract_with_carry_engine

Synopsis

// In header: <boost/random/subtract_with_carry.hpp>
template<typename IntType, std::size_t w, std::size_t s, std::size_t r> 
class subtract_with_carry_engine {
public:
  // types
  typedef IntType result_type;
  // construct/copy/destruct
  subtract_with_carry_engine();
  explicit subtract_with_carry_engine(IntType);
  template<typename SeedSeq> explicit subtract_with_carry_engine(SeedSeq &);
  template<typename It> subtract_with_carry_engine(It &, It);
  // public member functions
  void seed();
  void seed(IntType);
  template<typename SeedSeq> void seed(SeedSeq &);
  template<typename It> void seed(It &, It);
  result_type operator()();
  void discard(boost::uintmax_t);
  template<typename It> void generate(It, It);
  // 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 subtract_with_carry_engine &);
  template<typename CharT, typename Traits> 
    friend std::basic_istream< CharT, Traits > & 
    operator>>(std::basic_istream< CharT, Traits > &, 
               const subtract_with_carry_engine &);
  friend bool operator==(const subtract_with_carry_engine &, 
                         const subtract_with_carry_engine &);
  friend bool operator!=(const subtract_with_carry_engine &, 
                         const subtract_with_carry_engine &);
  // public data members
  static const std::size_t word_size;
  static const std::size_t long_lag;
  static const std::size_t short_lag;
  static const uint32_t default_seed;
  static const bool has_fixed_range;
  static const result_type modulus;
};

Description

Обоснование<subtract_with_carry_engine>моделигенератора псевдослучайных чисел. Алгоритм описывается в

«Новый класс генераторов случайных чисел», Джордж Марсалья и Ариф Заман, «Анналы прикладной вероятности», том 1, номер 3 (1991), 462-480.

`subtract_with_carry_engine` public construct/copy/destruct

<
```
subtract_with_carry_engine();
```
>
Построение нового<subtract_with_carry_engine>и семя по умолчанию.
<
```
explicitsubtract_with_carry_engine(IntTypevalue);
```
>
Строит новое<subtract_with_carry_engine>и сеет его<value>.
<
```
template<typenameSeedSeq>explicitsubtract_with_carry_engine(SeedSeq&seq);
```
>
Постраивает новый<subtract_with_carry_engine>и сеет его со значениями, произведенными<seq.generate()>.
<
```
template<typenameIt>subtract_with_carry_engine(It&first,Itlast);
```
>
Постраивает новый<subtract_with_carry_engine>и сеет его со значениями из диапазона. Сначала обновляются, чтобы указать одну мимо последней потребленной стоимости. Если в диапазоне недостаточно элементов, чтобы заполнить все состояние генератора, бросает<std::invalid_argument>.

`subtract_with_carry_engine` public member functions

<
```
voidseed();
```
>
Семена генератора с семенами по умолчанию.
<
```
voidseed(IntTypevalue);
```
>
<
```
template<typenameSeedSeq>voidseed(SeedSeq&seq);
```
>
Семена генератора со значениями, произведенными<seq.generate()>
.
<
```
template<typenameIt>voidseed(It&first,Itlast);
```
>
Семена генератора со значениями из диапазона. Обновления<first>, чтобы указать на одну из последних потребленных величин. Если диапазон не содержит достаточного количества элементов, чтобы заполнить все состояние генератора, бросает<std::invalid_argument>.
<
```
result_typeoperator()();
```
>
Возвращает следующее значение генератора.
<
```
voiddiscard(boost::uintmax_tz);
```
>
Улучшает состояние генератора<z>
.
<
```
template<typenameIt>voidgenerate(Itfirst,Itlast);
```
>
Заполняет диапазон случайными значениями.

`subtract_with_carry_engine` public static functions

<
```
staticresult_typemin();
```
>
Возвращает наименьшее значение, которое может произвести генератор.
<
```
staticresult_typemax();
```
>
Возвращает наибольшее значение, которое может произвести генератор.

`subtract_with_carry_engine` friend functions

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

Пишет<subtract_with_carry_engine><std::ostream>

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

Читает<subtract_with_carry_engine>из<std::istream>

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

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

Class template subtract_with_carry_engine

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

Boost C++ Libraries

Class template subtract_with_carry_engine

Synopsis

Description

subtract_with_carry_engine public construct/copy/destruct

subtract_with_carry_engine public member functions

subtract_with_carry_engine public static functions

subtract_with_carry_engine friend functions

`subtract_with_carry_engine` public construct/copy/destruct

`subtract_with_carry_engine` public member functions

`subtract_with_carry_engine` public static functions

`subtract_with_carry_engine` friend functions