azalea/kotlin-fork
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add a note about the Random(...) generators being not thread-safe

Browse Source
This commit is contained in:
Ilya Gorbunov
2020-03-21 03:11:16 +03:00
parent 44ffed9590
commit d7007044c2
1 changed files with 4 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
libraries/stdlib/src/kotlin/random/Random.kt
+4
View File
@@ -282,6 +282,8 @@ public abstract class Random {
* *Note:* Future versions of Kotlin may change the algorithm of this seeded number generator so that it will return * *Note:* Future versions of Kotlin may change the algorithm of this seeded number generator so that it will return
* a sequence of values different from the current one for a given seed. * a sequence of values different from the current one for a given seed.
* *
* On JVM the returned generator is NOT thread-safe. Do not invoke it from multiple threads without proper synchronization.
*
* @sample samples.random.Randoms.seededRandom * @sample samples.random.Randoms.seededRandom
*/ */
@SinceKotlin("1.3") @SinceKotlin("1.3")
@@ -295,6 +297,8 @@ public fun Random(seed: Int): Random = XorWowRandom(seed, seed.shr(31))
* *Note:* Future versions of Kotlin may change the algorithm of this seeded number generator so that it will return * *Note:* Future versions of Kotlin may change the algorithm of this seeded number generator so that it will return
* a sequence of values different from the current one for a given seed. * a sequence of values different from the current one for a given seed.
* *
* On JVM the returned generator is NOT thread-safe. Do not invoke it from multiple threads without proper synchronization.
*
* @sample samples.random.Randoms.seededRandom * @sample samples.random.Randoms.seededRandom
*/ */
@SinceKotlin("1.3") @SinceKotlin("1.3")