QRandomGenerator Class

멤버 함수 문서

이 함수는 과부하 함수입니다.

이 함수는 매개변수의 유형이 정확히 일치하지 않을 때 과부하 해결을 돕기 위해 존재합니다. 작은 유형을 큰 유형의 유형으로 승격하고 올바른 과부하를 호출합니다.

QRandomGenerator::QRandomGenerator(quint32 seedValue = 1)

seedValue 값을 시드로 사용하여 이 QRandomGenerator 객체를 초기화합니다. 동일한 시드 값으로 생성되거나 다시 시드된 두 개체는 동일한 숫자 시퀀스를 생성합니다.

seed() 및 securelySeeded()도 참조하세요 .

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

이것은 오버로드된 함수입니다.

seedBuffer 배열에서 찾은 값을 시드로 사용하여 이 QRandomGenerator 객체를 초기화합니다. 동일한 시드 값으로 생성되거나 다시 시드된 두 개체는 동일한 숫자 시퀀스를 생성합니다.

seed() 및 securelySeeded()도 참조하세요 .

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

이것은 오버로드된 함수입니다.

시드 시퀀스 sseq 를 시드로 사용하여 이 QRandomGenerator 객체를 초기화합니다. 동일한 시드 값으로 생성되거나 다시 시드된 두 개체는 동일한 숫자 시퀀스를 생성합니다.

seed() 및 securelySeeded()도 참조하세요 .

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

이것은 오버로드된 함수입니다.

begin ~ end 범위에서 찾은 값을 시드로 사용하여 이 QRandomGenerator 객체를 초기화합니다. 동일한 시드 값으로 생성되거나 다시 시드된 두 개의 객체는 동일한 숫자 시퀀스를 생성합니다.

이 생성자는 다음과 같습니다:

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

seed() 및 securelySeeded()도 참조하세요 .

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

이것은 오버로드된 함수입니다.

seedBuffer 배열에 있는 len 값을 시드로 사용하여 이 QRandomGenerator 객체를 초기화합니다. 동일한 시드 값으로 생성되거나 다시 시드된 두 개의 객체는 동일한 숫자 시퀀스를 생성합니다.

이 생성자는 다음과 같습니다:

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

seed() 및 securelySeeded()도 참조하세요 .

QRandomGenerator::QRandomGenerator(const QRandomGenerator &other)

other 객체에 생성기 상태의 복사본을 만듭니다. other 가 QRandomGenerator::system() 또는 그 복사본인 경우 이 객체는 운영 체제의 무작위 생성 기능에서도 읽습니다. 이 경우 두 객체에서 생성되는 시퀀스는 서로 다릅니다.

다른 모든 경우에는 새 QRandomGenerator 객체는 other 객체와 결정론적 시퀀스의 동일한 위치에서 시작됩니다. 이 시점부터 두 객체 모두 동일한 시퀀스를 생성합니다.

따라서 QRandomGenerator::global()의 복사본을 만드는 것은 바람직하지 않습니다. 독점적인 결정론적 생성기가 필요한 경우 대신 securelySeeded()를 사용하여 QRandomGenerator::global()와 관계를 공유하지 않는 새 객체를 얻는 것을 고려하세요.

double QRandomGenerator::bounded(double highest)

0(포함)과 highest (제외) 사이의 범위에서 임의의 2배를 하나 생성합니다. 이 함수는 다음과 동일하며 다음과 같이 구현됩니다:

    return generateDouble() * highest;

highest 매개변수가 음수이면 결과도 음수가 되고, 무한대 또는 NaN이면 결과도 무한대 또는 NaN이 됩니다(즉, 무작위가 아님).

generateDouble() 및 bounded()도 참조하세요 .

int QRandomGenerator::bounded(int highest)

이 함수는 오버로드된 함수입니다.

0(포함)과 highest (제외) 사이의 범위에서 임의의 32비트 수량을 하나 생성합니다. highest 은 양수여야 합니다.

이 함수는 전체 32비트 범위의 값을 얻는 데 사용할 수 없습니다. 대신 generate()를 사용하고 int로 형변환합니다.

generate(), generate64() 및 generateDouble()도 참조하세요 .

qint64 QRandomGenerator::bounded(qint64 highest)

이 함수는 오버로드된 함수입니다.

0(포함)과 highest (제외) 사이의 범위에서 임의의 64비트 수량을 하나 생성합니다. highest 은 양수여야 합니다.

이 함수는 qint64 의 전체 64비트 범위의 값을 구하는 데 사용할 수 없습니다. 대신 generate64()를 사용하여 qint64로 캐스팅하거나 이 함수의 부호 없는 버전을 사용하세요.

generate(), generate64() 및 generateDouble()도 참조하세요 .

quint32 QRandomGenerator::bounded(quint32 highest)

이 함수는 오버로드된 함수입니다.

0(포함)에서 highest (제외) 사이의 범위에서 임의의 32비트 수량을 하나 생성합니다. 매개변수 0과 를 사용하여 동일한 결과를 얻을 수도 있습니다. std::uniform_int_distribution 를 매개변수 0 및 highest - 1 과 함께 사용하여 동일한 결과를 얻을 수도 있습니다. 이 클래스는 32비트보다 큰 수량을 구하는 데에도 사용할 수 있으며 64비트의 경우 64비트 bounded() 오버로드도 사용할 수 있습니다.

예를 들어 0에서 255(포함) 사이의 값을 얻으려면 다음과 같이 작성하면 됩니다:

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

물론 generate()의 결과를 하위 8비트로만 마스킹하여 동일한 결과를 얻을 수도 있습니다. 두 솔루션 모두 똑같이 효율적입니다.

이 함수는 전체 32비트 범위의 값을 쿼트32로 구하는 데는 사용할 수 없습니다. 대신 generate()를 사용하세요.

generate(), generate64() 및 generateDouble()도 참조하세요 .

quint64 QRandomGenerator::bounded(quint64 highest)

이 함수는 오버로드된 함수입니다.

0(포함)에서 highest (제외) 사이의 범위에서 임의의 64비트 수량을 하나 생성합니다. 파라미터 0과 를 사용하여 동일한 결과를 얻을 수도 있습니다. std::uniform_int_distribution<quint64> 를 매개변수 0 및 highest - 1 과 함께 사용하여 동일한 결과를 얻을 수도 있습니다.

이 함수는 quint64 의 전체 64비트 범위의 값을 얻는 데는 사용할 수 없습니다. 대신 generate64()를 사용하세요.

generate(), generate64() 및 generateDouble()도 참조하세요 .

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

이 함수는 오버로드된 함수입니다.

lowest (포함)과 highest (제외) 사이의 범위에서 임의의 32비트 수량을 하나 생성합니다(둘 다 음수일 수 있지만 highest 은 lowest 보다 커야 함).

이 함수는 전체 32비트 범위의 값을 얻는 데 사용할 수 없습니다. 대신 generate()를 사용하고 int로 형변환하세요.

generate(), generate64() 및 generateDouble()도 참조하십시오 .

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

이 함수는 오버로드된 함수입니다.

lowest (포함)과 highest (제외) 사이의 범위에서 임의의 64비트 양을 하나 생성하며, 둘 다 음수일 수 있지만 highest 은 lowest 보다 커야 합니다.

이 함수는 qint64 의 전체 64비트 범위의 값을 구하는 데 사용할 수 없습니다. 대신 generate64()를 사용하고 qint64로 캐스팅하세요.

generate(), generate64() 및 generateDouble()도 참조하세요 .

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

이 함수는 오버로드된 함수입니다.

lowest (포함)에서 highest (제외) 사이의 범위에서 임의의 32비트 수량을 하나 생성합니다. highest 매개 변수는 lowest 보다 커야 합니다.

매개 변수 std::uniform_int_distribution 와 함께 lowest 및 \a highest - 1 을 사용하여 동일한 결과를 얻을 수도 있습니다. 이 클래스는 32비트보다 큰 수량을 얻는 데에도 사용할 수 있습니다.

예를 들어 1000(포함)과 2000(제외) 사이의 값을 얻으려면 다음과 같이 작성합니다:

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

이 함수는 전체 32비트 범위인 quint32의 값을 구하는 데는 사용할 수 없습니다. 대신 generate()를 사용하십시오.

generate(), generate64() 및 generateDouble()도 참조하세요 .

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

이 함수는 오버로드된 함수입니다.

lowest (포함)에서 highest (제외) 사이의 범위에서 임의의 64비트 수량을 하나 생성합니다. 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 32비트 또는 64비트 수량(유형에 따라 UInt)을 생성하여 buffer 배열에 저장합니다. 이 방법은 난수 생성기 소스에 대한 호출 횟수를 줄여주므로 한 번에 두 개 이상의 수량을 얻을 수 있는 가장 효율적인 방법입니다.

예를 들어 두 개의 32비트 수량을 채우려면 한 번만 쓰면 됩니다:

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

generate64()를 한 번 호출한 다음 64비트 값의 두 절반을 분할하는 방법도 가능합니다.

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(); });

이 함수는 부호 없는 32비트 정수가 필요한 함수 std::seed_seq::generate함수의 요구 사항을 준수하며, 부호 없는 32비트 정수 값이 필요합니다.

시작, 끝) 범위가 요소당 32비트 이상을 저장할 수 있는 영역을 가리키는 경우 요소는 여전히 32비트 데이터로만 초기화됩니다. 다른 비트는 0이 됩니다. 범위를 64비트 수량으로 채우려면 쓸 수 있습니다:

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

범위가 배열이나 QList)의 데이터와 같이 인접한 메모리를 참조하는 경우 fillRange() 함수도 사용할 수 있습니다.

fillRange()도 참조하세요 .

double QRandomGenerator::generateDouble()

표준 범위 [0, 1)(즉, 0을 포함하고 1을 제외)에서 임의의 큐리얼 하나를 생성합니다.

이 함수는 다음과 같습니다:

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

매개변수 0과 1을 사용하여 std::uniform_real_distribution 를 사용하여도 동일하게 얻을 수 있습니다.

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(다윈), BSD, Linux, Windows. 다른 운영 체제에서도 마찬가지일 수 있습니다.

또한 실제 하드웨어 난수 생성기에 의해 지원될 수도 있습니다. 따라서 이 함수가 반환하는 QRandomGenerator 을 대량 데이터 생성에 사용해서는 안 됩니다. 대신 QRandomGenerator 또는 <random> 헤더의 무작위 엔진을 시딩하는 데 사용하세요.

이 함수가 반환하는 객체는 스레드에 안전하며 잠금 없이 모든 스레드에서 사용할 수 있습니다. 또한 복사할 수 있으며 그 결과 QRandomGenerator 역시 운영 체제 기능에 액세스할 수 있지만 동일한 시퀀스를 생성하지는 않습니다.

참고: 이 함수는 스레드에 안전합니다.

securelySeeded() 및 global()도 참조하세요 .

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

32비트 난수를 생성하여 반환합니다.

generate() 및 generate64()도 참조하세요 .