std::negative_binomial_distribution<IntType>:: negative_binomial_distribution

From cppreference.com
C++
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
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)
Pseudo-random number generation
Random number distributions
Uniform distributions
(C++11)
(C++11)
(C++11)
Bernoulli distributions
(C++11)
(C++11)
(C++11)
(C++11)
Poisson distributions
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Normal distributions
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Sampling distributions
(C++11)
(C++11)
(C++11)
std::negative_binomial_distribution
negative_binomial_distribution ( ) : negative_binomial_distribution ( 1 ) { }
(1) (since C++11)
explicit negative_binomial_distribution ( IntType k, double p = 0.5 ) ;
(2) (since C++11)
explicit negative_binomial_distribution ( const param_type & params ) ;
(3) (since C++11)

Constructs a new distribution object.

2) Uses k and p as the distribution parameters.
3) Uses params as the distribution parameters.

Parameters

k - the k distribution parameter (number of trial successes)
p - the p distribution parameter (probability of a trial generating true )
params - the distribution parameter set

Notes

Requires that 0 < p ≤ 1 and 0 < k .

If p == 1 , subsequent calls to the operator() overload that does not accept a param_type object will cause undefined behavior.

The default-constructed std::negative_binomial_distribution is equivalent to the default-constructed std::geometric_distribution .

Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

DR Applied to Behavior as published Correct behavior
P0935R0 C++11 default constructor was explicit made implicit
Retrieved from " https://en.cppreference.com/mwiki/index.php?title=cpp/numeric/random/negative_binomial_distribution/negative_binomial_distribution&oldid=151330 "