QRandomGenerator Class

メンバ関数ドキュメント

これはオーバーロードされた関数です。

この関数は、パラメータの型が完全に一致しない場合に、オーバーロードの解決を助けるために存在する。小さい方の型を大きい方の型に昇格させ、正しいオーバーロードを呼び出す。

QRandomGenerator::QRandomGenerator(quint32 seedValue = 1)

このQRandomGeneratorオブジェクトをシードとして値seedValue で初期化する。同じシード値で構築または再シードされた2つのオブジェクトは、同じ数列を生成する。

seed() とsecurelySeeded()も参照 。

template <qsizetype N> QRandomGenerator::QRandomGenerator(const quint32 (&)[N] seedBuffer)

これはオーバーロードされた関数である。

配列seedBuffer で見つかった値をシードとして、この QRandomGenerator オブジェクトを初期化します。同じシード値で構築または再シードされた2つのオブジェクトは、同じ数列を生成します。

seed() およびsecurelySeeded()も参照 。

[noexcept] QRandomGenerator::QRandomGenerator(std::seed_seq &sseq)

これはオーバーロードされた関数です。

シード配列sseq をシードとしてこの QRandomGenerator オブジェクトを初期化する。同じシード値で構築または再シードされた2つのオブジェクトは、同じ数列を生成します。

seed() とsecurelySeeded()も参照 。

QRandomGenerator::QRandomGenerator(const quint32 *begin, const quint32 *end)

これはオーバーロードされた関数である。

begin からend までの範囲で見つかった値をシードとして、この QRandomGenerator オブジェクトを初期化します。同じシード値で構築または再シードされた2つのオブジェクトは、同じ数列を生成します。

このコンストラクタは以下と等価である：

    std::seed_seq sseq(begin, end);
    QRandomGenerator generator(sseq);

seed() およびsecurelySeeded()も参照のこと 。

QRandomGenerator::QRandomGenerator(const quint32 *seedBuffer, qsizetype len)

これはオーバーロードされた関数である。

配列seedBuffer で見つかったlen の値をシードとして、この QRandomGenerator オブジェクトを初期化します。同じシード値で構築または再シードされた2つのオブジェクトは、同じ数列を生成します。

このコンストラクタは以下と等価である：

    std::seed_seq sseq(seedBuffer, seedBuffer + len);
    QRandomGenerator generator(sseq);

seed() およびsecurelySeeded()も参照 。

QRandomGenerator::QRandomGenerator(const QRandomGenerator &other)

other オブジェクトに生成状態のコピーを作成する。other がQRandomGenerator::system() またはそのコピーの場合、このオブジェクトはオペレーティングシステムのランダム生成機能からも読み込まれます。この場合、2つのオブジェクトが生成するシーケンスは異なる。

それ以外のすべての場合において、新しいQRandomGeneratorオブジェクトは、other オブジェクトがあったのと同じ決定論的シーケンスの同じ位置から始まる。両オブジェクトはこの時点から同じシーケンスを生成する。

そのため、QRandomGenerator::global()のコピーを作成することは勧められない。排他的決定性ジェネレータが必要な場合は、代わりにQRandomGenerator::global() と何の関係も持たない新しいオブジェクトを得るためにsecurelySeeded() を使用することを検討してください。

double QRandomGenerator::bounded(double highest)

0（包含）からhighest （排他的）までの範囲で、1つのランダムなdoubleを生成する。この関数は次の関数と等価であり、次のように実装される：

    return generateDouble() * highest;

highest パラメータが負の場合、結果も負になる。無限または NaN の場合、結果も無限または NaN になる（つまり、ランダムではない）。

generateDouble() および bounded()も参照のこと 。

int QRandomGenerator::bounded(int highest)

これはオーバーロードされた関数である。

0（包含）～highest （排他的）の範囲内で32ビットの乱数を1つ生成する。highest は正でなければならない。

この関数は、intの全32ビット範囲の値を取得するためには使用できないことに注意。代わりに、generate （）を使用し、intにキャストする。

generate()、generate64()、generateDouble()も参照 。

qint64 QRandomGenerator::bounded(qint64 highest)

これはオーバーロードされた関数です。

0（包含）からhighest （排他的）までの範囲で、64 ビットのランダムな数量を 1 つ生成します。highest は正でなければなりません。

この関数を使用して、qint64 の 64 ビット範囲すべての値を取得することはできないことに注意してください。代わりに、generate64 （）を使用して qint64 にキャストするか、この関数の符号なしバージョンを使用してください。

generate(),generate64(),generateDouble()も参照の こと。

quint32 QRandomGenerator::bounded(quint32 highest)

これはオーバーロードされた関数である。

0（包含）～highest （排他的）の範囲内で32ビットの乱数を1つ生成する。同じ結果は std::uniform_int_distributionhighest - 1を使用しても同じ結果を得ることができます。このクラスは、32 ビットより大きな値を得るためにも使用できます。64 ビットの場合は、64 ビット bounded() オーバーロードも使用できます。

例えば、0から255（を含む）の間の値を得るには、次のように書く：

    quint32 v = QRandomGenerator::global()->bounded(256);

当然ながら、generate()の結果を下位8ビットだけにマスクすることでも、同じ値を得ることができる。どちらの方法でも効率的である。

この関数は、quint32の全32ビット範囲の値を取得するために使用できないことに注意してください。代わりにgenerate() を使用する。

generate()、generate64()、generateDouble()も参照 。

quint64 QRandomGenerator::bounded(quint64 highest)

これはオーバーロードされた関数です。

0（排他的）からhighest （排他的）までの範囲内で、1 つのランダムな 64 ビット量を生成します。同じ結果は std::uniform_int_distribution<quint64>highest - 1を使用しても同じ結果が得られます。

この関数は、quint64 の全 64 ビット範囲の値を取得するために使用することはできないことに注意してください。 代わりに、generate64 （）を使用してください。

generate(),generate64(),generateDouble()も参照の こと。

int QRandomGenerator::bounded(int lowest, int highest)

これはオーバーロードされた関数である。

lowest （包含）とhighest （排他的）の間の範囲にある1つのランダムな32ビット量を生成する。どちらも負であってもよいが、highest はlowest より大きくなければならない。

この関数は、intの32ビット全範囲の値を得るためには使用できないことに注意。代わりに、generate （）を使用し、intにキャストする。

generate()、generate64()、generateDouble()も参照 。

qint64 QRandomGenerator::bounded(qint64 lowest, qint64 highest)

これはオーバーロードされた関数です。

lowest （包含）とhighest （排他）の間の範囲に64ビットのランダムな数量を1つ生成します。どちらも負であってもかまいませんが、highest はlowest より大きくなければなりません。

この関数は、qint64 の完全な 64 ビット範囲の値を取得するために使用できないことに注意してください。代わりに、generate64 （）を使用し、qint64 にキャストしてください。

generate(),generate64(),generateDouble()も参照の こと。

quint32 QRandomGenerator::bounded(quint32 lowest, quint32 highest)

これはオーバーロードされた関数である。

lowest （排他的）からhighest （排他的）までの範囲で、1つのランダムな32ビット量を生成する。パラメータhighest はlowest より大きくなければならない。

同じ結果は std::uniform_int_distributionをパラメータlowest と\a highest - 1 で使用しても同じ結果が得られます。このクラスは、32 ビットより大きな値を取得するためにも使用できます。

例えば、1000(含む)と2000(含まない)の間の値を得るには、次のように書きます：

    quint32 v = QRandomGenerator::global()->bounded(1000, 2000);

この関数はquint32の全32ビット範囲の値を取得するために使用できないことに注意してください。代わりに、generate （）を使用する。

generate()、generate64()、generateDouble()も参照の こと。

quint64 QRandomGenerator::bounded(quint64 lowest, quint64 highest)

これはオーバーロードされた関数です。

lowest （包含）からhighest （排他的）までの範囲で、64 ビットのランダムな数量を 1 つ生成します。パラメータhighest はlowest より大きくなければならない。

同じ結果は std::uniform_int_distribution<quint64>をパラメータlowest と\a highest - 1 で使用しても同じ結果を得ることができる。

この関数は、quint64 の全 64 ビット範囲の値を取得するために使用できないことに注意。代わりに、generate64 （）を使用する。

generate()、generate64()、generateDouble()も参照のこと 。

void QRandomGenerator::discard(unsigned long long z)

シーケンスから次のz エントリを破棄する。このメソッドは、generate()z を何度も呼び出して結果を破棄するのと同じである：

    while (z--)
        generator.generate();

template <typename UInt, size_t N, QRandomGenerator::IfValidUInt<UInt> = true> void QRandomGenerator::fillRange(UInt (&)[N] buffer)

N UInt 32 ビットまたは 64 ビット量（型による）を生成し、 配列に格納する。これは、乱数発生源の呼び出し回数を減らすことができるため、一度に複数の量を取得する最も効率的な方法です。buffer

例えば、2つの32ビット量を生成するには、次のように書くことができる：

    quint32 array[2];
    QRandomGenerator::global()->fillRange(array);

また、generate64 （）を1回呼び出して、64ビット値の2つの半分を分割することも可能である。

generate()も参照のこと 。

template <typename UInt, QRandomGenerator::IfValidUInt<UInt> = true> void QRandomGenerator::fillRange(UInt *buffer, qsizetype count)

count 32ビットまたは64ビットの量を生成し（UInt の型による）、buffer が指すバッファに格納する。これは、乱数生成ソースの呼び出し回数を減らすことができるため、一度に複数の量を取得する最も効率的な方法です。

例えば、16個のエントリのリストを乱数値で埋めるには、次のように記述する：

    QList<quint32> list;
    list.resize(16);
    QRandomGenerator::global()->fillRange(list.data(), list.size());

generate()も参照のこと 。

quint64 QRandomGenerator::generate64()

64ビットの乱数値を生成し、それを返します。

operator()() およびgenerate() も参照 。

quint32 QRandomGenerator::generate()

32 ビット乱数値を生成して返す。

operator()() およびgenerate64() も参照 。

template <typename ForwardIterator> void QRandomGenerator::generate(ForwardIterator begin, ForwardIterator end)

32 ビット量を生成し、begin からend までの範囲に格納する。この関数は以下と等価である（として実装されている）：

    std::generate(begin, end, [this]() { return generate(); });

この関数は、関数 std::seed_seq::generateこの関数は、符号なし32ビット整数値を必要とする関数[begin, end]の要件に準拠しています。

begin, end)の範囲が、要素ごとに32ビット以上のデータを格納できる領域を指している場合でも、要素は32ビットのデータのみで初期化されることに注意してください。それ以外のビットはゼロになります。範囲を64ビットで埋めるには、次のように書けばよい：

    std::generate(begin, end, []() { return QRandomGenerator::global()->generate64(); });

範囲が連続したメモリ（配列やQList のデータなど）を指す場合、fillRange （）関数も使用できる。

fillRange()も参照のこと 。

double QRandomGenerator::generateDouble()

正規範囲[0, 1]（つまり、0を含み1を含まない）のランダムなqrealを1つ生成します。

この関数は

    QRandomGenerator64 rd;
    return std::generate_canonical<qreal, std::numeric_limits<qreal>::digits>(rd);

と等価です。 std::uniform_real_distributionをパラメータ 0 と 1 で使用しても同じものが得られます。

generate()、generate64()、bounded()も参照 。

[static] QRandomGenerator *QRandomGenerator::global()

securelySeeded() を使用してシードされた共有QRandomGenerator へのポインタを返す。この関数は、特定の用途のためにセキュアにシードされたQRandomGenerator を作成したり、かなり大きなQRandomGenerator オブジェクトを保存したりすることなく、ランダム・データを作成するために使用する必要があります。

例えば、以下の例では、ランダムなRGBカラーを作成している：

    return QColor::fromRgb(QRandomGenerator::global()->generate());

このオブジェクトへのアクセスはスレッドセーフであるため、どのスレッドでもロックなしで使用できる。このオブジェクトはコピーすることもでき、コピーによって生成されるシーケンスは、共有オブジェクトが生成するシーケンスと同じになる。しかし、グローバルオブジェクトにアクセスする他のスレッドがある場合、それらのスレッドは予測できない間隔でサンプルを取得する可能性があることに注意してください。

注意：この関数はスレッドセーフである。

securelySeeded() およびsystem()も参照のこと 。

[static constexpr] QRandomGenerator::result_type QRandomGenerator::max()

QRandomGenerator が生成する可能性のある最大値を返します。すなわち、std::numeric_limits<result_type>::max() 。

min() および QRandomGenerator64::max() も参照 。

[static constexpr] QRandomGenerator::result_type QRandomGenerator::min()

QRandomGenerator が生成する可能性のある最小値を返す。つまり 0。

max() および QRandomGenerator64::min() も参照 。

[static] QRandomGenerator QRandomGenerator::securelySeeded()

QRandomGenerator::system() で安全にシードされた新しいQRandomGenerator オブジェクトを返す。この関数は、QRandomGenerator が使用するアルゴリズムにとって理想的なシードサイズを得るので、しばらくの間保持される新しいQRandomGenerator オブジェクトを作成するための推奨方法である。

決定論的エンジンを安全にシードするために必要なデータ量を考えると、この関数はやや高価であり、QRandomGenerator の短期的な使用には使用すべきではありません（2600バイト未満のランダム・データを生成するためにこの関数を使用することは、事実上リソースの無駄遣いです）。それほど多くのデータを必要としない場合は、QRandomGenerator::global() を使用し、QRandomGenerator オブジェクトを格納しないことを検討してください。

global() およびsystem()も参照 。

void QRandomGenerator::seed(quint32 seed = 1)

値seed をシードとして使用して、このオブジェクトを播種します。

[noexcept] void QRandomGenerator::seed(std::seed_seq &seed)

これはオーバーロードされた関数です。

シード配列seed をシードとしてこのオブジェクトを播種する。

[static] QRandomGenerator *QRandomGenerator::system()

オペレーティングシステムが提供する機能を常に使用して乱数を生成する共有QRandomGenerator へのポインタを返します。このシステム機能は、少なくとも以下のオペレーティング・システムでは暗号的に安全であると考えられている：Apple OS (Darwin)、BSD、Linux、Windows。他のオペレーティング・システムでも同様かもしれない。

また、真のハードウェア乱数ジェネレーターに支えられている可能性もある。そのため、この関数が返すQRandomGenerator は、データの一括生成には使用しないでください。代わりに、QRandomGenerator または <random> ヘッダからランダムエンジンをシードするために使用してください。

この関数が返すオブジェクトはスレッドセーフであり、ロックのない任意のスレッドで使用することができる。また、このオブジェクトはコピーすることもでき、その結果生成されるQRandomGenerator もオペレーティングシステムの機能にアクセスするが、同じシーケンスは生成されない。

注：この関数はスレッドセーフである。

securelySeeded() およびglobal()も参照のこと 。

QRandomGenerator::result_type QRandomGenerator::operator()()

32ビット乱数を生成し、それを返す。

generate() およびgenerate64()も参照の こと。