std::philox_engine<UIntType,w,n,r,consts>::discard

From cppreference.com

Compiler support
Freestanding and hosted
Language
Standard library
Standard library headers
Named requirements
Feature test macros(C++20)
Language support library
Concepts library(C++20)
Diagnostics library
Memory management library
Metaprogramming library(C++11)
General utilities library
Containers library
Iterators library
Ranges library(C++20)
Algorithms library
Strings library
Text processing library
Numerics library
Date and time library
Input/output library
Filesystem library(C++17)
Concurrency support library(C++11)
Execution control library(C++26)
Technical specifications
Symbols index
External libraries

[edit]

Numerics library

Common mathematical functions

Mathematical special functions(C++17)

Mathematical constants(C++20)

Basic linear algebra algorithms(C++26)

Data-parallel types (SIMD)(C++26)

Floating-point environment(C++11)

Complex numbers

Numeric array (valarray)

Pseudo-random number generation

Bit manipulation(C++20)

Saturation arithmetic(C++26)

(C++17)

(C++17)

(C++20)

(C++20)

Generic numeric operations

iota (C++11)
ranges::iota (C++23)
accumulate
inner_product
adjacent_difference
partial_sum

reduce (C++17)
transform_reduce (C++17)
inclusive_scan (C++17)
exclusive_scan (C++17)
transform_inclusive_scan (C++17)
transform_exclusive_scan (C++17)

C-style checked integer arithmetic

ckd_add (C++26)
ckd_sub (C++26)

ckd_mul (C++26)

[edit]

Pseudo-random number generation

Uniform random bit generators

uniform_random_bit_generator

(C++20)

Random number engines

linear_congruential_engine

(C++11)

mersenne_twister_engine

(C++11)

subtract_with_carry_engine

(C++11)

philox_engine

(C++26)

Random number engine adaptors

discard_block_engine

(C++11)

independent_bits_engine

(C++11)

shuffle_order_engine

(C++11)

Predefined random number generators

Non-deterministic random numbers

(C++11)

(C++11)

(C++11)

Random number algorithms

ranges::generate_random

(C++26)

Random number 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)

[edit]

std::philox_engine

Member functions
philox_engine::philox_engine
philox_engine::seed
philox_engine::set_counter
Generation
philox_engine::operator()
philox_engine::discard
Characteristics
philox_engine::min
philox_engine::max
Non-member functions
operator== (C++26)
operator<<operator>> (C++26)(C++26)

[edit]

void discard(unsignedlonglong z);

Advances the internal state byz times.

[edit]Parameters

integer value specifying the number of times to advance the state by

[edit]Complexity

No worse than the complexity ofz consecutive calls tooperator().

[edit]Notes

This function can use “fast jump” algorithms which advance the state by many steps (order of millions) without calculating intermediate state transitions can be used instead of naive loops that callsoperator()z times and discarding the result.