Index: sdk/lib/math/random.dart |
diff --git a/sdk/lib/math/random.dart b/sdk/lib/math/random.dart |
index 0c1c76cf81c85c0fa5d8c57efc63271e568f5a86..47c55828ce4f2267d524b2a8d1926034de7320de 100644 |
--- a/sdk/lib/math/random.dart |
+++ b/sdk/lib/math/random.dart |
@@ -9,23 +9,34 @@ part of dart.math; |
* |
* The default implementation supplies a stream of |
* pseudo-random bits that are not suitable for cryptographic purposes. |
+ * |
+ * Use the Random.secure() constructor for cryptographic |
+ * purposes. |
*/ |
abstract class Random { |
/** |
* Creates a random number generator. |
* |
- * The optional parameter [seed] is used |
- * to initialize the internal state of the generator. The implementation of |
- * the random stream can change between releases of the library. |
+ * The optional parameter [seed] is used to initialize the |
+ * internal state of the generator. The implementation of the |
+ * random stream can change between releases of the library. |
*/ |
external factory Random([int seed]); |
/** |
+ * Creates a cryptographically secure random number generator. |
+ * |
+ * If the program cannot provide a cryptographically secure |
+ * source of random numbers, it throws an [UnsupportedError]. |
+ */ |
+ external factory Random.secure(); |
+ |
+ /** |
* Generates a non-negative random integer uniformly distributed in the range |
* from 0, inclusive, to [max], exclusive. |
* |
* Implementation note: The default implementation supports [max] values |
- * between 1 and ((1<<32) - 1) inclusive. |
+ * between 1 and (1<<32) inclusive. |
*/ |
int nextInt(int max); |