.\" Updated 2008-08-08, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v3.05
.\"
.TH RAND 3 2008-08-29 "" "Linux Programmer's Manual"
-.SH ̾Á°
-rand, srand \- Íð¿ô¤òÀ¸À®¤¹¤ë´Ø¿ô
-.SH ½ñ¼°
+.SH 名前
+rand, srand \- 乱数を生成する関数
+.SH 書式
.nf
.B #include <stdlib.h>
.sp
.fi
.sp
.in -4n
-glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
+glibc 向けの機能検査マクロの要件
.RB ( feature_test_macros (7)
-»²¾È):
+参照):
.in
.sp
.BR rand_r ():
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE
-.SH ÀâÌÀ
+.SH 説明
.BR rand ()
-´Ø¿ô¤Ï [0,\ \fBRAND_MAX\fR] ¤ÎÈϰϤε¿»÷Íð¿ôÀ°¿ô¤òÊÖ¤¹¡£
+関数は [0,\ \fBRAND_MAX\fR] の範囲の疑似乱数整数を返す。
.PP
.BR srand ()
-´Ø¿ô¤Ï¡¢
+関数は、
.BR rand ()
-´Ø¿ô¤Çºî¤é¤ì¤ëµ¿»÷Íð¿ôÀ°¿ô·ÏÎó¤Î¿·¤·¤¤¼ï¤È¤·¤Æ¡¢
-¤½¤Î°ú¤¿ô¤ÎÃͤò»ÈÍѤ¹¤ë¡£
-¤³¤ì¤é¤Î´Ø¿ô¤ò»ÈÍѤ·¤Æºî¤é¤ì¤¿µ¿»÷Íð¿ô·ÏÎó¤Ï¡¢
-Ʊ¤¸Ãͤò°ú¤¿ô¤È¤·¤Æ
+関数で作られる疑似乱数整数系列の新しい種として、
+その引き数の値を使用する。
+これらの関数を使用して作られた疑似乱数系列は、
+同じ値を引き数として
.BR srand ()
-¤ò¸Æ¤Ö¤³¤È¤Ç¡¢
-ºÆ¸½¤¹¤ë¤³¤È¤¬²Äǽ¤Ç¤¢¤ë¡£
+を呼ぶことで、
+再現することが可能である。
.PP
-¼ï¤ÎÃͤ¬Í¿¤¨¤é¤ì¤Ê¤¤¾ì¹ç¤Ë¤Ï¡¢
+種の値が与えられない場合には、
.BR rand ()
-´Ø¿ô¤Ï
-¼«Æ°Åª¤Ë 1 ¤ò¼ï¤È¤¹¤ë¡£
+関数は
+自動的に 1 を種とする。
.PP
.BR rand ()
-´Ø¿ô¤ÏºÆÆþ²Äǽ (reentrant) ¤Ç¤Ï¤Ê¤¤¡¢¤Ä¤Þ¤ê¥¹¥ì¥Ã¥É¡¦¥»¡¼¥Õ¤Ç¤Ï¤Ê¤¤¡£
-¤Ê¤¼¤Ê¤é¡¢¤³¤Î´Ø¿ô¤Ï±£¤·¾õÂÖ¤ò»ý¤Ã¤Æ¤ª¤ê¡¢¸Æ¤Ó½Ð¤µ¤ì¤ëÅÙ¤ËÊѹ¹¤¹¤ë¤«¤é¤Ç¤¢¤ë¡£
-¤Á¤ç¤¦¤É¤³¤Î±£¤·¾õÂÖ¤¬¼¡¤Î¸Æ¤Ó½Ð¤·»þ¤ÎÍð¿ô¤Î¼ï¤È¤·¤Æ»È¤ï¤ì¤ë¤è¤¦¤Ê¤â¤Î¤Ç¤¢¤ë¡£
-¼ÂºÝ¤Ë¤Ï¤â¤¦¾¯¤·Ê£»¨¤«¤â¤·¤ì¤Ê¤¤¤¬¡£¥¹¥ì¥Ã¥É¤ò»ÈÍѤ¹¤ë¥¢¥×¥ê¥±¡¼¥·¥ç¥ó¤Ç
-ºÆ¸½²Äǽ¤ÊÆ°ºî¤ò¤µ¤»¤¿¤¤¾ì¹ç¤Ë¤Ï¡¢¤³¤Î±£¤·¾õÂÖ¤¬¸¶°ø¤ÇºÆ¸½À¤¬¤Ê¤¯¤Ê¤ë¡£
+関数は再入可能 (reentrant) ではない、つまりスレッド・セーフではない。
+なぜなら、この関数は隠し状態を持っており、呼び出される度に変更するからである。
+ちょうどこの隠し状態が次の呼び出し時の乱数の種として使われるようなものである。
+実際にはもう少し複雑かもしれないが。スレッドを使用するアプリケーションで
+再現可能な動作をさせたい場合には、この隠し状態が原因で再現性がなくなる。
.BR rand_r ()
-´Ø¿ô¤Ï
+関数は
.I unsigned int
-·¿¤ÎÊÑ¿ô¤Ø¤Î¥Ý¥¤¥ó¥¿¤ò°ú¤¿ô¤Ë¤È¤ê¡¢
-¤³¤ÎÊÑ¿ô¤ò¾õÂÖ³ÊǼÍѤ˻ÈÍѤ¹¤ë¡£
-¾õÂÖ¿ô¤¬Èó¾ï¤Ë¾®¤µ¤¤¤Î¤Ç¡¢¤³¤Î´Ø¿ô¤Ï¤¢¤Þ¤ê¤è¤¤µ¼»÷Íð¿ôÀ¸À®´ï¤È¤Ï¸À¤¨¤Ê¤¤¤À¤í¤¦¡£
-Âå¤ï¤ê¤Ë
+型の変数へのポインタを引き数にとり、
+この変数を状態格納用に使用する。
+状態数が非常に小さいので、この関数はあまりよい擬似乱数生成器とは言えないだろう。
+代わりに
.BR drand48_r (3)
-¤ò»È¤¦¤È¤è¤¤¡£
-.SH ÊÖ¤êÃÍ
+を使うとよい。
+.SH 返り値
.BR rand ()
-¤È
+と
.BR rand_r ()
-´Ø¿ô¤Ï 0 ¤È
+関数は 0 と
.B RAND_MAX
-¤Î´Ö¤Î¿ô¤òÊÖ¤¹¡£
+の間の数を返す。
.BR srand ()
-´Ø¿ô¤ÏÃͤòÊÖ¤µ¤Ê¤¤¡£
-.SH ½àµò
-´Ø¿ô
+関数は値を返さない。
+.SH 準拠
+関数
.BR rand ()
-¤È
+と
.BR srand ()
-¤Ï SVr4, 4.3BSD, C89, C99, POSIX.1-2001 ¤Ë½àµò¤·¤Æ¤¤¤ë¡£
-´Ø¿ô
+は SVr4, 4.3BSD, C89, C99, POSIX.1-2001 に準拠している。
+関数
.BR rand_r ()
-¤Ï POSIX.1-2001 ¤ËͳÍ褹¤ë¡£
-POSIX.1-2008 ¤Ï¡¢
+は POSIX.1-2001 に由来する。
+POSIX.1-2008 は、
.BR rand_r ()
-¤òÇÑ»ßͽÄê¤È¤·¤Æ¤¤¤ë¡£
-.SH Ãí°Õ
+を廃止予定としている。
+.SH 注意
.BR rand ()
-¤È
+と
.BR srand ()
-¤Î Linux C Library ÈǤϡ¢
+の Linux C Library 版は、
.BR random (3)
-¤È
+と
.BR srandom (3)
-¤Îξ´Ø¿ô¤ÈƱ¤¸Íð¿ôÀ¸À®
-¥¢¥ë¥´¥ê¥º¥à¤ò»ÈÍѤ·¤Æ¤¤¤ë¡£¤½¤Î¤¿¤á¡¢²¼°Ì¤Î¥Ó¥Ã¥È¤Ï¾å°Ì¤Î¥Ó¥Ã¥È¤È
-Ʊ¤¸¤¯¤é¤¤¤Ë¥é¥ó¥À¥à¤Ç¤¢¤ë¡£
-¤·¤«¤·¡¢µìÈǤÎ
+の両関数と同じ乱数生成
+アルゴリズムを使用している。そのため、下位のビットは上位のビットと
+同じくらいにランダムである。
+しかし、旧版の
.BR rand ()
-¤Î¼ÂÁõ¤ä¡¢Â¾¤Î¥·¥¹¥Æ¥à¤Î¸½ºß¤Î¼ÂÁõ¤Ç¤Ï¡¢²¼°Ì¤Î¥Ó¥Ã¥È¤¬¾å°Ì¤Î¥Ó¥Ã¥È¤Û¤É
-¥é¥ó¥À¥à¤Ë¤Ê¤Ã¤Æ¤¤¤Ê¤¤¡£°Ü¿¢À¤ò¹â¤á¤ë¾ì¹ç¤Ç¤â¡¢ÀºÅ٤ι⤤Íð¿ô¤¬É¬ÍפÊ
-¥¢¥×¥ê¥±¡¼¥·¥ç¥ó¤Ç¤Ï¤³¤Î´Ø¿ô¤Ï»ÈÍѤ·¤Æ¤Ï¤¤¤±¤Ê¤¤
-(Âå¤ï¤ê¤Ë
+の実装や、他のシステムの現在の実装では、下位のビットが上位のビットほど
+ランダムになっていない。移植性を高める場合でも、精度の高い乱数が必要な
+アプリケーションではこの関数は使用してはいけない
+(代わりに
.BR random (3)
-¤ò»È¤¦¤³¤È)¡£
-.SH Îã
-POSIX 1003.1-2003 ¤Ç¤Ï¡¢
+を使うこと)。
+.SH 例
+POSIX 1003.1-2003 では、
.BR rand ()
-¤È
+と
.BR srand ()
-¤Î¼ÂÁõÎã¤È¤·¤Æ°Ê²¼¤òµó¤²¤Æ¤¤¤ë¡£¤³¤ì¤Ï¡¢°Û¤Ê¤ë£²¤Ä¤Î¥Þ¥·¥ó¤ÇƱ¤¸Íð¿ô·ÏÎó¤¬
-ɬÍפʾì¹ç¤Ë¤ÏÊØÍø¤Ç¤¢¤í¤¦¡£
+の実装例として以下を挙げている。これは、異なる２つのマシンで同じ乱数系列が
+必要な場合には便利であろう。
.sp
.in +4n
.nf
static unsigned long next = 1;
-/* RAND_MAX ¤ò 32767 ¤È²¾Äê */
+/* RAND_MAX を 32767 と仮定 */
int myrand(void) {
next = next * 1103515245 + 12345;
return((unsigned)(next/65536) % 32768);
}
.fi
.in
-.SH ´ØÏ¢¹àÌÜ
+.SH 関連項目
.BR drand48 (3),
.BR random (3)
OSDN Git Service
