std::discard_block_engine

Defined in header `<random>`
template< class Engine, size_t P, size_t R > class discard_block_engine;		(since C++11)

discard_block_engine is a pseudo-random number generator adaptor that discards a certain amount of data produced by the base engine. From each block of size P generated by the base engine, the adaptor keeps only R numbers, discarding the rest.

Template parameters

Engine	-	the type of the wrapped engine
P	-	the size of a block. Must be greater than $0$ .
R	-	the number of used numbers per block. Must be greater than $0$ and not greater than `P`
Type requirements
- `Engine` must meet the requirements of `RandomNumberEngine`.

Member types

Member type	Definition
`result_type`	`Engine::result_type`

Member functions

(constructor)	constructs the engine adaptor (public member function)
seed	sets the state of the underlying engine (public member function)
base	returns the underlying engine (public member function)
Generation
operator()	advances the state of the underlying engine and returns the generated value (public member function)
discard	advances the adaptor's state by a specified amount (public member function)
Characteristics
min [static]	gets the smallest possible value in the output range of the underlying engine. (public static member function)
max [static]	gets the largest possible value in the output range of the underlying engine. (public static member function)

Non-member functions

operator==operator!=	compares the internal states of the adaptors and underlying engines (function)
operator<<operator>>	performs stream input and output on pseudo-random number engine adaptor (function)

Member objects

constexpr size_t block_size [static]	the size of the block, `P` (public static member constant)
constexpr size_t used_size [static]	the number of used numbers per block, `R` (public static member constant)

Language
Standard library headers
Concepts
Utilities library
Strings library
Containers library
Algorithms library
Iterators library
Numerics library
Input/output library
Localizations library
Regular expressions library (C++11)
Atomic operations library (C++11)
Thread support library (C++11)
Filesystem library (C++17)
Technical Specifications

Common mathematical functions
Special mathematical functions
Floating-point environment (C++11)
Complex numbers
Numeric arrays
Pseudo-random number generation
Compile-time rational arithmetic (C++11)
Numeric algorithms
gcd (C++17)
lcm (C++17)
Generic numeric operations
iota (C++11)
accumulate
inner_product
adjacent_difference
partial_sum

Engines and engine adaptors
linear_congruential_engine (C++11)
mersenne_twister_engine (C++11)
subtract_with_carry_engine (C++11)
discard_block_engine (C++11)
independent_bits_engine (C++11)
shuffle_order_engine (C++11)
Generators
random_device (C++11)
Distributions
Uniform distributions
uniform_int_distribution (C++11)
uniform_real_distribution (C++11)
generate_canonical (C++11)
Bernoulli distributions
bernoulli_distribution (C++11)
binomial_distribution (C++11)
negative_binomial_distribution (C++11)
geometric_distribution (C++11)
Poisson distributions
poisson_distribution (C++11)
exponential_distribution (C++11)
gamma_distribution (C++11)
weibull_distribution (C++11)
extreme_value_distribution (C++11)
Normal distributions
normal_distribution (C++11)
lognormal_distribution (C++11)
chi_squared_distribution (C++11)
cauchy_distribution (C++11)
fisher_f_distribution (C++11)
student_t_distribution (C++11)
Sampling distributions
discrete_distribution (C++11)
piecewise_constant_distribution (C++11)
piecewise_linear_distribution (C++11)
Seed Sequences
seed_seq (C++11)
C library
rand
srand
RAND_MAX

Member functions
discard_block_engine::discard_block_engine
discard_block_engine::seed
discard_block_engine::base
Generation
discard_block_engine::operator()
discard_block_engine::discard
Characteristics
discard_block_engine::min
discard_block_engine::max
Non-member functions
operator==operator!=
operator<<operator>>