random_negative_binomial_distribution

random_negative_binomial_distribution (음이항 분포)

std::negative_binomial_distribution은 이산 확률 함수에 따라 분포된 임의의 음이 아닌 정수 값 i를 생성하는 분포 클래스예요. C++11부터 사용할 수 있어요.

출처: cppreference

본문

<random> 헤더에 정의되어 있고, 시그니처는 다음과 같아요.

template< class IntType = int >
class negative_binomial_distribution;

(since C++11)

이산 확률 함수에 따라 분포된 임의의 음이 아닌 정수 값 i를 생성해요:

P(i|k, p) = C(k+i-1, i) · p^k · (1-p)^i

이 값은 정확히 k번의 성공이 발생하기 전에, 일련의 독립적인 예/아니오 시행(각각 확률 p로 성공)에서의 실패 횟수를 나타내요.

std::negative_binomial_distribution은 RandomNumberDistribution을 만족해요.

템플릿 매개변수 (Template parameters)

  • IntType — 결과 타입. 표준 정수 타입 중 하나가 아니면 효과는 정의되지 않아요.

멤버 타입 (Member types)

멤버 타입 정의
result_type (C++11) IntType
param_type 매개변수 집합의 타입

멤버 함수 (Member functions)

  • (constructor) — 새 분포 생성
  • reset — 내부 상태 재설정
  • 생성: operator() — 다음 난수 생성
  • 특성: k, p — 분포 매개변수 반환; param — 매개변수 객체 얻기/설정; min — 최솟값; max — 최댓값

비멤버 함수 (Non-member functions)

  • operator== operator!= — 두 분포 객체 비교
  • operator<< operator>> (C++11) — 스트림 입출력

예제 (Example)

이 코드를 실행해 봐요.

#include <iostream>
#include <map>
#include <random>

int main()
{
    std::random_device rd;
    std::mt19937 gen(rd());
    std::negative_binomial_distribution<> d(5, 0.5); // k=5, p=0.5

    std::map<int, int> hist;
    for (int n = 0; n != 10000; ++n)
        ++hist[d(gen)];

    for (auto [x, count] : hist)
        if (x < 20)
            std::cout << x << ": " << std::string(count / 200, '*') << '\n';
}

더 알아보기 (Learn more)

cppreference