std::rand

 

C++

言語

標準ライブラリヘッダ

フリースタンディング処理系とホスト処理系

名前付き要件

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

ユーティリティライブラリ

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ (C++20)

アルゴリズムライブラリ

数値演算ライブラリ

入出力ライブラリ

ローカライゼーションライブラリ

正規表現ライブラリ (C++11)

アトミック操作ライブラリ (C++11)

スレッドサポートライブラリ (C++11)

ファイルシステムライブラリ (C++17)

技術仕様書

 

数値演算ライブラリ

一般的な数学関数

数学の特殊関数 (C++17)

数学定数 (C++20)

浮動小数点環境 (C++11)

複素数

数値配列

擬似乱数生成

コンパイル時有理数算術 (C++11)

数値演算アルゴリズム

gcd (C++17)

lcm (C++17)

補間

midpoint (C++20)

lerp (C++20)

汎用の数値演算

iota (C++11)

accumulate

inner_product

adjacent_difference

partial_sum

reduce (C++17)

transform_reduce (C++17)

inclusive_scan (C++17)

exclusive_scan (C++17)

transform_inclusive_scan (C++17)

transform_exclusive_scan (C++17)

ビット操作

bit_cast (C++20)

ispow2 (C++20)

ceil2 (C++20)

floor2 (C++20)

log2p1 (C++20)

rotl (C++20)

rotr (C++20)

countl_zero (C++20)

countl_one (C++20)

countr_zero (C++20)

countr_one (C++20)

popcount (C++20)

endian (C++20)

 

擬似乱数生成

一様ランダムビットジェネレータ

uniform_random_bit_generator (C++20)

エンジンとエンジンアダプタ

linear_congruential_engine (C++11)

mersenne_twister_engine (C++11)

subtract_with_carry_engine (C++11)

discard_block_engine (C++11)

independent_bits_engine (C++11)

shuffle_order_engine (C++11)

非決定的なジェネレータ

random_device (C++11)

分布

一様分布

uniform_int_distribution (C++11)

uniform_real_distribution (C++11)

generate_canonical (C++11)

ベルヌーイ分布

bernoulli_distribution (C++11)

binomial_distribution (C++11)

negative_binomial_distribution (C++11)

geometric_distribution (C++11)

ポアソン分布

poisson_distribution (C++11)

exponential_distribution (C++11)

gamma_distribution (C++11)

weibull_distribution (C++11)

extreme_value_distribution (C++11)

正規分布

normal_distribution (C++11)

lognormal_distribution (C++11)

chi_squared_distribution (C++11)

cauchy_distribution (C++11)

fisher_f_distribution (C++11)

student_t_distribution (C++11)

標本分布

discrete_distribution (C++11)

piecewise_constant_distribution (C++11)

piecewise_linear_distribution (C++11)

シードシーケンス

seed_seq (C++11)

C のライブラリ

rand

srand

RAND_MAX

 

ヘッダ <cstdlib> で定義
int rand();

​0​ と RAND_MAX の間 (0 および RAND_MAX も含まれます) の擬似乱数の整数値を返します。

std::srand() は rand() によって使用される擬似乱数ジェネレータをシードします。 いかなる srand() の呼び出しよりも前に rand() が使用された場合、 rand() は srand(1) によってシードされたかのように動作します。

srand() を使用して rand() がシードされるたびに、連続する呼び出しに対して同じ値のシーケンスを生成しなければなりません。 標準ライブラリの他の関数が rand を呼ぶかもしれません。 どの関数がそうであるかは処理系定義です。

rand() がスレッドセーフかどうかは処理系定義です。

引数

(なし)

戻り値

​0​ と RAND_MAX の間の擬似乱数の整数値。

ノート

生成される乱数シーケンスの品質についての保証はありません。 過去には、 rand() の実装によっては、生成されるシーケンスのランダム性、分散、周期に深刻な欠陥がありました (広く知られているひとつの例は、呼ぶたびに下位ビットが 1 と 0 を交互に繰り返していました)。

rand() は本格的な乱数生成のニーズに対しては推奨されません。 rand() を置き換える C++11 の乱数生成機能の使用が推奨されます。 (C++11以上)

例

Run this code

#include <cstdlib>
#include <iostream>
#include <ctime>
 
int main() 
{
    std::srand(std::time(nullptr)); // use current time as seed for random generator
    int random_variable = std::rand();
    std::cout << "Random value on [0 " << RAND_MAX << "]: " 
              << random_variable << '\n';
 
    // roll a 6-sided die 20 times
    for (int n=0; n != 20; ++n) {
        int x = 7;
        while(x > 6) 
            x = 1 + std::rand()/((RAND_MAX + 1u)/6);  // Note: 1+rand()%6 is biased
        std::cout << x << ' ';
    }
}

出力例:

Random value on [0 2147483647]: 726295113
6 3 6 2 6 5 6 3 1 1 1 6 6 6 4 1 3 6 4 2

関連項目

uniform_int_distribution (C++11)	範囲内に一様に分布した整数値を生成します (クラステンプレート)
srand	擬似乱数ジェネレータをシードします (関数)
RAND_MAX	std::rand によって生成可能な最大値 (マクロ定数)
randint	指定された範囲のランダムな整数を生成します (関数テンプレート)
rand の C言語リファレンス