| OLD | NEW |
| 1 // Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file |
| 2 // for details. All rights reserved. Use of this source code is governed by a | 2 // for details. All rights reserved. Use of this source code is governed by a |
| 3 // BSD-style license that can be found in the LICENSE file. | 3 // BSD-style license that can be found in the LICENSE file. |
| 4 | 4 |
| 5 part of dart.math; | 5 part of dart.math; |
| 6 | 6 |
| 7 /** | 7 /** |
| 8 * A generator of random bool, int, or double values. | 8 * A generator of random bool, int, or double values. |
| 9 * | 9 * |
| 10 * The default implementation supplies a stream of | 10 * The default implementation supplies a stream of |
| 11 * pseudo-random bits that are not suitable for cryptographic purposes. | 11 * pseudo-random bits that are not suitable for cryptographic purposes. |
| 12 */ | 12 */ |
| 13 abstract class Random { | 13 abstract class Random { |
| 14 /** | 14 /** |
| 15 * Creates a random-number generator. The optional parameter [seed] is used | 15 * Creates a random-number generator. The optional parameter [seed] is used |
| 16 * to initialize the internal state of the generator. The implementation of | 16 * to initialize the internal state of the generator. The implementation of |
| 17 * the random stream can change between releases of the library. | 17 * the random stream can change between releases of the library. |
| 18 * | |
| 19 * Implementation note: The default implementation uses up to 64-bits of seed. | |
| 20 */ | 18 */ |
| 21 external factory Random([int seed]); | 19 external factory Random([int seed]); |
| 22 | 20 |
| 23 /** | 21 /** |
| 24 * Generates a positive random integer uniformly distributed on the range | 22 * Generates a positive random integer uniformly distributed on the range |
| 25 * from 0, inclusive, to [max], exclusive. | 23 * from 0, inclusive, to [max], exclusive. |
| 26 * | 24 * |
| 27 * Implementation note: The default implementation supports [max] values | 25 * Implementation note: The default implementation supports [max] values |
| 28 * between 1 and ((1<<32) - 1) inclusive. | 26 * between 1 and ((1<<32) - 1) inclusive. |
| 29 */ | 27 */ |
| 30 int nextInt(int max); | 28 int nextInt(int max); |
| 31 | 29 |
| 32 /** | 30 /** |
| 33 * Generates a positive random floating point value uniformly distributed on | 31 * Generates a positive random floating point value uniformly distributed on |
| 34 * the range from 0.0, inclusive, to 1.0, exclusive. | 32 * the range from 0.0, inclusive, to 1.0, exclusive. |
| 35 */ | 33 */ |
| 36 double nextDouble(); | 34 double nextDouble(); |
| 37 | 35 |
| 38 /** | 36 /** |
| 39 * Generates a random boolean value. | 37 * Generates a random boolean value. |
| 40 */ | 38 */ |
| 41 bool nextBool(); | 39 bool nextBool(); |
| 42 } | 40 } |
| OLD | NEW |