最終更新日時: 2025年10月23日 01時15分43秒 (JST)
Akira Takahashi が更新

履歴 編集

function
<random>

# std::cauchy_distribution::コンストラクタ(C++11)

    explicit cauchy_distribution(RealType a = 0.0, RealType b = 1.0); // (1)
    cauchy_distribution() : cauchy_distribution(0.0) {}               // (1) C++20

    explicit cauchy_distribution(RealType a, RealType b = 1.0);       // (2) C++20

    explicit cauchy_distribution(const param_type& parm);             // (3)

## 概要

- (1) : デフォルトコンストラクタ
  - C++17まで : コーシー分布の位置母数`a`および尺度母数`b`を受け取るコンストラクタ。
  - C++20 : コーシー分布の位置母数`a = 0.0`および尺度母数`b = 1.0`として(2)に委譲。
- (2) : コーシー分布の位置母数`a`および尺度母数`b`を受け取るコンストラクタ。
- (3) : パラメータオブジェクトを受け取るコンストラクタ。`param_type`は、このクラスの(1)のコンストラクタと同じオーバーロードを持ち、それらのコンストラクタのパラメータを保持している。このコンストラクタでは、`param`オブジェクトが持っているパラメータを、このクラスのコンストラクタに転送する。

## 要件

- (2) : `b > 0`であること

## 例

    #include <iostream>
    #include <random>
    #include <cstdint>

    int main()
    {
      std::random_device seed_gen;
      std::uint32_t seed = seed_gen();
      std::default_random_engine engine(seed);

      // パラメータを個別に指定する
      {
        // 位置母数0.0、尺度母数1.0で分布させる
        std::cauchy_distribution<> dist(0.0, 1.0);

        for (int i = 0; i < 10; ++i) {
          double result = dist(engine);
          std::cout << result << std::endl;
        }
      }
      std::cout << std::endl;

      // パラメータを通して範囲指定する
      {
        using dist_type = std::cauchy_distribution<>;

        // 位置母数0.0、尺度母数1.0で分布させる
        dist_type::param_type param(0.0, 1.0);
        dist_type dist(param);

        for (int i = 0; i < 10; ++i) {
          double result = dist(engine);
          std::cout << result << std::endl;
        }
      }
    }

### 出力例

    -8.68106
    -1.45595
    2.20777
    0.447975
    8.15704
    0.564086
    19.9933
    1.95861
    -0.20131
    -0.00596668

    0.174368
    -0.775221
    -0.508034
    3.46587
    -10.5451
    24.0844
    1.07661
    0.786653
    3.71786
    1.59971

## バージョン

### 言語

- C++11

### 処理系

- Clang: ??
- GCC: 4.7.2 ✅
- ICC: ??
- Visual C++: ??

## 参照

- P0935R0 Eradicating unnecessarily explicit default constructors from the standard library