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 // A part of the dart:math library. | 5 // A part of the dart:math library. |
6 | 6 |
7 /** | 7 /** |
8 * A random number generator. The default implementation supplies a stream of | 8 * A random number generator. The default implementation supplies a stream of |
9 * pseudo-random bits which is not suitable for cryptographic purposes. | 9 * pseudo-random bits which is not suitable for cryptographic purposes. |
10 */ | 10 */ |
11 class Random { | 11 class Random { |
12 /** | 12 /** |
13 * Creates a random-number generator. The optional parameter [seed] is used | 13 * Creates a random-number generator. The optional parameter [seed] is used |
14 * to initialize the internal state of the generator. The implementation of | 14 * to initialize the internal state of the generator. The implementation of |
15 * the random stream can change between releases of the library. | 15 * the random stream can change between releases of the library. |
16 * | 16 * |
17 * Implementation note: The default implementation uses up to 64-bits of seed. | 17 * Implementation note: The default implementation uses up to 64-bits of seed. |
18 */ | 18 */ |
19 external factory Random([int seed]); | 19 external factory Random([int seed]); |
20 | 20 |
21 /** | 21 /** |
22 * Generates a positive random integer uniformly distributed on the range | 22 * Generates a positive random integer uniformly distributed on the range |
23 * from 0, inclusive, to [max], exclusive. | 23 * from 0, inclusive, to [max], exclusive. |
24 * | 24 * |
25 * Implementation note: The default implementation supports [max] values | 25 * Implementation note: The default implementation supports [max] values |
26 * between 1 and ((1<<32) - 1) inclusive. | 26 * between 1 and ((1<<32) - 1) inclusive. |
27 */ | 27 */ |
28 abstract int nextInt(int max); | 28 int nextInt(int max); |
29 | 29 |
30 /** | 30 /** |
31 * Generates a positive random floating point value uniformly distributed on | 31 * Generates a positive random floating point value uniformly distributed on |
32 * the range from 0.0, inclusive, to 1.0, exclusive. | 32 * the range from 0.0, inclusive, to 1.0, exclusive. |
33 */ | 33 */ |
34 abstract double nextDouble(); | 34 double nextDouble(); |
35 | 35 |
36 /** | 36 /** |
37 * Generates a random boolean value. | 37 * Generates a random boolean value. |
38 */ | 38 */ |
39 abstract bool nextBool(); | 39 bool nextBool(); |
40 } | 40 } |
OLD | NEW |