Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/numeric/random/independent bits engine"

From cppreference.com
< cpp‎ | numeric‎ | random
(+)
 
m (→‎Template parameters: {{c/core}}.)
 
(24 intermediate revisions by 8 users not shown)
Line 1: Line 1:
 
{{cpp/title|independent_bits_engine}}
 
{{cpp/title|independent_bits_engine}}
−
{{cpp/numeric/random/independent_bits_engine/sidebar}}
+
{{cpp/numeric/random/independent_bits_engine/navbar}}
−
{{ddcl | header=random | notes={{mark c++11 feature}} | 1=
+
{{ddcl|header=random|since=c++11|
 
template<
 
template<
−
     class Engine,  
+
     class Engine,
−
     size_t w,  
+
     std::size_t W,
 
     class UIntType
 
     class UIntType
 
> class independent_bits_engine;
 
> class independent_bits_engine;
 
}}
 
}}
  
−
{{todo}}
+
{{ttt|independent_bits_engine}} is a random number engine adaptor that produces random numbers with different number of bits than that of the wrapped engine.
 +
 
 +
===Template parameters===
 +
{{par begin}}
 +
{{par|Engine|the type of the wrapped engine}}
 +
{{par|W|the number of bits the generated numbers should have}}
 +
{{par|UIntType|the type of the generated random numbers. The effect is undefined unless the parameter is cv-unqualified and is one of {{c/core|unsigned short}}, {{c/core|unsigned int}}, {{c/core|unsigned long}}, or {{c/core|unsigned long long}}.}}
 +
{{par hreq}}
 +
{{par req named|Engine|RandomNumberEngine}}
 +
{{par req|{{tt|W}} must be greater than zero, and no greater than {{c|std::numeric_limits<UIntType>::digits}}.}}
 +
{{par end}}
  
 
===Member types===
 
===Member types===
−
{{tdcl list begin}}
+
{{dsc begin}}
−
{{tdcl list hitem | Member type | Definition}}
+
{{dsc hitem|Member type|Definition}}
−
{{tdcl list item | {{tt|result_type}} | {{cpp|typename Engine::result_type}} }}
+
{{dsc|{{tt|result_type}} {{mark c++11}}|{{tt|UIntType}}}}
−
{{tdcl list end}}
+
{{dsc end}}
  
 
===Member functions===
 
===Member functions===
−
{{dcl list begin}}
+
{{dsc begin}}
−
{{dcl list template | cpp/numeric/random/engine/dcl list constructor |independent_bits_engine}}
+
{{dsc inc|cpp/numeric/random/adaptor/dsc constructor|independent_bits_engine}}
−
{{dcl list template | cpp/numeric/random/engine/dcl list seed |independent_bits_engine}}
+
{{dsc inc|cpp/numeric/random/adaptor/dsc seed|independent_bits_engine}}
−
{{dcl list template | cpp/numeric/random/engine/dcl list base |independent_bits_engine}}
+
{{dsc inc|cpp/numeric/random/adaptor/dsc base|independent_bits_engine}}
  
−
{{dcl list h2 | Generation}}
+
{{dsc h2|Generation}}
−
{{dcl list template | cpp/numeric/random/engine/dcl list operator() |independent_bits_engine}}
+
{{dsc inc|cpp/numeric/random/adaptor/dsc operator()|independent_bits_engine}}
−
{{dcl list template | cpp/numeric/random/engine/dcl list discard |independent_bits_engine}}
+
{{dsc inc|cpp/numeric/random/adaptor/dsc discard|independent_bits_engine}}
  
−
{{dcl list h2 | Characteristics}}
+
{{dsc h2|Characteristics}}
−
{{dcl list template | cpp/numeric/random/engine/dcl list min |independent_bits_engine}}
+
{{dsc inc|cpp/numeric/random/adaptor/dsc min|independent_bits_engine}}
−
{{dcl list template | cpp/numeric/random/engine/dcl list max |independent_bits_engine}}
+
{{dsc inc|cpp/numeric/random/adaptor/dsc max|independent_bits_engine}}
−
{{tdcl list end}}
+
{{dsc end}}
  
 
===Non-member functions===
 
===Non-member functions===
−
{{dcl list begin}}
+
{{dsc begin}}
−
{{dcl list template | cpp/numeric/random/engine/dcl list operator_eq |independent_bits_engine}}
+
{{dsc inc|cpp/numeric/random/adaptor/dsc operator_cmp|independent_bits_engine}}
−
{{dcl list template | cpp/numeric/random/engine/dcl list operator_ltltgtgt |independent_bits_engine}}
+
{{dsc inc|cpp/numeric/random/adaptor/dsc operator_ltltgtgt|independent_bits_engine}}
−
{{dcl list end}}
+
{{dsc end}}
 +
 
 +
===Example===
 +
{{example}}
 +
 
 +
{{langlinks|de|es|fr|it|ja|pt|ru|zh}}

Latest revision as of 16:31, 19 March 2024

 
C++
 
Numerics library
Common mathematical functions
Mathematical special functions (C++17)
Mathematical constants (C++20)
Basic linear algebra algorithms (C++26)
Floating-point environment (C++11)
Complex numbers
Numeric array (valarray)
Pseudo-random number generation
Factor operations
(C++17)
(C++17)
Interpolations
(C++20)
(C++20)
Saturation arithmetic
(C++26)
(C++26)
(C++26)
(C++26)
(C++26)

Generic numeric operations
Bit operations
(C++20)    
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++23)
(C++20)
 
Pseudo-random number generation
 
std::independent_bits_engine
 
Defined in header <random>
template<

    class Engine,
    std::size_t W,
    class UIntType

> class independent_bits_engine;
 (since C++11)

independent_bits_engine is a random number engine adaptor that produces random numbers with different number of bits than that of the wrapped engine.

Contents

[edit] Template parameters

Engine - the type of the wrapped engine
W - the number of bits the generated numbers should have
UIntType - the type of the generated random numbers. The effect is undefined unless the parameter is cv-unqualified and is one of unsigned short, unsigned int, unsigned long, or unsigned long long.
Type requirements
-
Engine must meet the requirements of RandomNumberEngine.
-
W must be greater than zero, and no greater than std::numeric_limits<UIntType>::digits.

[edit] Member types

Member type Definition
result_type (C++11) UIntType

[edit] Member functions

(C++11)
 constructs the engine adaptor
(public member function) [edit]
(C++11)
 sets the state of the underlying engine
(public member function) [edit]
(C++11)
 returns the underlying engine
(public member function) [edit]
Generation
(C++11)
 advances the state of the underlying engine and returns the generated value
(public member function) [edit]
(C++11)
 advances the adaptor's state by a specified amount
(public member function) [edit]
Characteristics
[static] (C++11)
 gets the smallest possible value in the output range (always zero).
(public static member function) [edit]
[static] (C++11)
 gets the largest possible value in the output range (always 2w - 1).
(public static member function) [edit]

[edit] Non-member functions

(C++11)(C++11)(removed in C++20)
 compares the internal states of the adaptors and underlying engines
(function) [edit]
(C++11)
 performs stream input and output on pseudo-random number engine adaptor
(function) [edit]

[edit] Example

This section is incomplete
Reason: no example
Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/numeric/random/independent_bits_engine&oldid=170227"