QRandomGenerator Class

멤버 함수 설명

QRandomGenerator::QRandomGenerator(quint32 seedValue = 1)

이 QRandomGenerator 객체를 시드 값 seedValue 으로 초기화합니다. 동일한 시드 값으로 생성되거나 시드가 재설정된 두 객체는 동일한 숫자 시퀀스를 생성합니다.

seed() 및 securelySeeded()도 참조하십시오 .

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

이 QRandomGenerator 객체를 배열 ` seedBuffer `에 포함된 값들을 시드로 사용하여 초기화합니다. 동일한 시드 값으로 생성되거나 시드가 재설정된 두 객체는 동일한 숫자 시퀀스를 생성합니다.

seed() 및 securelySeeded()도 참조하십시오 .

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

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

seed() 및 securelySeeded()도 참조하십시오 .

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

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

이 생성자는 다음 코드와 동일합니다:

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

seed() 및 securelySeeded()도 참조하십시오 .

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

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

이 생성자는 다음 코드와 동일합니다:

    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()과 아무런 관련이 없는 새로운 객체를 생성하는 것을 고려해 보십시오.

[constexpr noexcept default] QRandomGenerator::~QRandomGenerator()

QRandomGenerator 의 인스턴스를 삭제합니다.

double QRandomGenerator::bounded(double highest)

0(포함)부터 highest (제외) 사이의 범위에서 임의의 double형 숫자 하나를 생성합니다. 이 함수는 다음 코드와 동일하며 다음과 같이 구현됩니다:

    return generateDouble() * highest;

highest 매개변수가 음수인 경우 결과도 음수가 되며, 무한대이거나 NaN인 경우 결과도 무한대이거나 NaN이 됩니다(즉, 무작위 결과가 아닙니다).

generateDouble() 및 bounded(quint64)도 참조하십시오 .

int QRandomGenerator::bounded(int highest)

0(포함)부터 highest (제외) 사이의 범위에서 32비트 무작위 수치를 하나 생성합니다. highest 는 양수여야 합니다.

이 함수는 int의 전체 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비트만 추출하는 방식으로 동일한 결과를 얻을 수도 있습니다. 두 방법 모두 동일한 효율을 보입니다.

이 함수는 quint32의 전체 32비트 범위에 해당하는 값을 구하는 데 사용할 수 없다는 점에 유의하십시오. 대신 generate()을 사용하십시오.

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

quint64 QRandomGenerator::bounded(quint64 highest)

0(포함)부터 highest (제외) 사이의 범위에서 64비트 임의의 수를 하나 생성합니다. 다음을 사용하여도 동일한 결과를 얻을 수 있습니다. 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 보다 커야 합니다.

이 함수는 int의 전체 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_distributionlowest 및 \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비트 임의의 수를 하나 생성합니다. 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 (&buffer)[N])

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

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

[begin, end) 범위가 요소당 32비트 이상을 저장할 수 있는 영역을 가리키는 경우에도, 요소들은 여전히 32비트의 데이터로만 초기화된다는 점에 유의하십시오. 나머지 비트는 0으로 설정됩니다. 이 범위를 64비트 수량으로 채우려면 다음과 같이 작성할 수 있습니다:

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

범위가 연속된 메모리(예: 배열이나 ` QList`의 데이터)를 가리키는 경우, ` fillRange()` 함수도 사용할 수 있습니다.

fillRange()도 참조하십시오 .

double QRandomGenerator::generateDouble()

표준 범위 [0, 1) (즉, 0을 포함하고 1을 제외한 범위) 내에서 qreal형 난수를 하나 생성합니다.

이 함수는 다음과 동일합니다:

    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()를 사용하여 시드(seed)가 설정된 공유 QRandomGenerator 객체에 대한 포인터를 반환합니다. 이 함수는 특정 용도를 위해 보안 시드가 설정된 QRandomGenerator 객체를 생성하는 데 드는 높은 비용이나, 상당히 큰 QRandomGenerator 객체를 저장하는 번거로움 없이 난수 데이터를 생성할 때 사용해야 합니다.

예를 들어, 다음 코드는 무작위 RGB 색상을 생성합니다:

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

이 객체에 대한 액세스는 스레드 안전하므로, 잠금(lock) 없이 어떤 스레드에서든 사용할 수 있습니다. 또한 이 객체를 복사할 수 있으며, 복사본에서 생성되는 시퀀스는 공유 객체에서 생성되는 시퀀스와 동일합니다. 다만, 다른 스레드가 전역 객체에 액세스하고 있는 경우, 해당 스레드들은 예측할 수 없는 간격으로 샘플을 얻을 수 있다는 점에 유의하십시오.

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

securelySeeded() 및 system()도 참조하십시오 .

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

QRandomGenerator 가 생성할 수 있는 최대 값을 반환합니다. 즉, std::numeric_limits<result_type>::max() 입니다.

min()도 참조하십시오 .

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

QRandomGenerator 가 생성할 수 있는 최소값을 반환합니다. 즉, 0입니다.

max()도 참조하십시오 .

[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>` 헤더의 난수 엔진에 시드 값을 설정하는 데 사용하십시오.

이 함수가 반환하는 객체는 스레드 안전하며, 잠금(lock) 없이 어떤 스레드에서든 사용할 수 있습니다. 또한 이 객체를 복사할 수 있으며, 그 결과로 생성된 QRandomGenerator 도 운영 체제 기능을 사용하지만, 동일한 시퀀스를 생성하지는 않습니다.

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

securelySeeded() 및 global()도 참조하십시오 .

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

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

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