OLD | NEW |
1 // Copyright 2013 the V8 project authors. All rights reserved. | 1 // Copyright 2013 the V8 project authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef V8_BASE_UTILS_RANDOM_NUMBER_GENERATOR_H_ | 5 #ifndef V8_BASE_UTILS_RANDOM_NUMBER_GENERATOR_H_ |
6 #define V8_BASE_UTILS_RANDOM_NUMBER_GENERATOR_H_ | 6 #define V8_BASE_UTILS_RANDOM_NUMBER_GENERATOR_H_ |
7 | 7 |
8 #include "src/base/macros.h" | 8 #include "src/base/macros.h" |
9 | 9 |
10 namespace v8 { | 10 namespace v8 { |
11 namespace base { | 11 namespace base { |
12 | 12 |
13 // ----------------------------------------------------------------------------- | 13 // ----------------------------------------------------------------------------- |
14 // RandomNumberGenerator | 14 // RandomNumberGenerator |
15 // | 15 |
16 // This class is used to generate a stream of pseudorandom numbers. The class | 16 // This class is used to generate a stream of pseudo-random numbers. The class |
17 // uses a 48-bit seed, which is modified using a linear congruential formula. | 17 // uses a 64-bit seed, which is passed through MurmurHash3 to create two 64-bit |
18 // (See Donald Knuth, The Art of Computer Programming, Volume 3, Section 3.2.1.) | 18 // state values. This pair of state values is then used in xorshift128+. |
| 19 // The resulting stream of pseudo-random numbers has a period length of 2^128-1. |
| 20 // See Marsaglia: http://www.jstatsoft.org/v08/i14/paper |
| 21 // And Vigna: http://vigna.di.unimi.it/ftp/papers/xorshiftplus.pdf |
| 22 |
19 // If two instances of RandomNumberGenerator are created with the same seed, and | 23 // If two instances of RandomNumberGenerator are created with the same seed, and |
20 // the same sequence of method calls is made for each, they will generate and | 24 // the same sequence of method calls is made for each, they will generate and |
21 // return identical sequences of numbers. | 25 // return identical sequences of numbers. |
22 // This class uses (probably) weak entropy by default, but it's sufficient, | 26 // This class uses (probably) weak entropy by default, but it's sufficient, |
23 // because it is the responsibility of the embedder to install an entropy source | 27 // because it is the responsibility of the embedder to install an entropy source |
24 // using v8::V8::SetEntropySource(), which provides reasonable entropy, see: | 28 // using v8::V8::SetEntropySource(), which provides reasonable entropy, see: |
25 // https://code.google.com/p/v8/issues/detail?id=2905 | 29 // https://code.google.com/p/v8/issues/detail?id=2905 |
26 // This class is neither reentrant nor threadsafe. | 30 // This class is neither reentrant nor threadsafe. |
27 | 31 |
28 class RandomNumberGenerator final { | 32 class RandomNumberGenerator final { |
(...skipping 47 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
76 int64_t NextInt64() WARN_UNUSED_RESULT; | 80 int64_t NextInt64() WARN_UNUSED_RESULT; |
77 | 81 |
78 // Fills the elements of a specified array of bytes with random numbers. | 82 // Fills the elements of a specified array of bytes with random numbers. |
79 void NextBytes(void* buffer, size_t buflen); | 83 void NextBytes(void* buffer, size_t buflen); |
80 | 84 |
81 // Override the current ssed. | 85 // Override the current ssed. |
82 void SetSeed(int64_t seed); | 86 void SetSeed(int64_t seed); |
83 | 87 |
84 int64_t initial_seed() const { return initial_seed_; } | 88 int64_t initial_seed() const { return initial_seed_; } |
85 | 89 |
| 90 // Static and exposed for external use. |
| 91 static inline double ToDouble(uint64_t state0, uint64_t state1) { |
| 92 // Exponent for double values for [1.0 .. 2.0) |
| 93 static const uint64_t kExponentBits = V8_UINT64_C(0x3FF0000000000000); |
| 94 static const uint64_t kMantissaMask = V8_UINT64_C(0x000FFFFFFFFFFFFF); |
| 95 uint64_t random = ((state0 + state1) & kMantissaMask) | kExponentBits; |
| 96 return bit_cast<double>(random) - 1; |
| 97 } |
| 98 |
| 99 // Static and exposed for external use. |
| 100 static inline void XorShift128(uint64_t* state0, uint64_t* state1) { |
| 101 uint64_t s1 = *state0; |
| 102 uint64_t s0 = *state1; |
| 103 *state0 = s0; |
| 104 s1 ^= s1 << 23; |
| 105 s1 ^= s1 >> 17; |
| 106 s1 ^= s0; |
| 107 s1 ^= s0 >> 26; |
| 108 *state1 = s1; |
| 109 } |
| 110 |
86 private: | 111 private: |
87 static const int64_t kMultiplier = V8_2PART_UINT64_C(0x5, deece66d); | 112 static const int64_t kMultiplier = V8_2PART_UINT64_C(0x5, deece66d); |
88 static const int64_t kAddend = 0xb; | 113 static const int64_t kAddend = 0xb; |
89 static const int64_t kMask = V8_2PART_UINT64_C(0xffff, ffffffff); | 114 static const int64_t kMask = V8_2PART_UINT64_C(0xffff, ffffffff); |
90 | 115 |
91 int Next(int bits) WARN_UNUSED_RESULT; | 116 int Next(int bits) WARN_UNUSED_RESULT; |
92 | 117 |
| 118 static uint64_t MurmurHash3(uint64_t); |
| 119 |
93 int64_t initial_seed_; | 120 int64_t initial_seed_; |
94 int64_t seed_; | 121 uint64_t state0_; |
| 122 uint64_t state1_; |
95 }; | 123 }; |
96 | 124 |
97 } // namespace base | 125 } // namespace base |
98 } // namespace v8 | 126 } // namespace v8 |
99 | 127 |
100 #endif // V8_BASE_UTILS_RANDOM_NUMBER_GENERATOR_H_ | 128 #endif // V8_BASE_UTILS_RANDOM_NUMBER_GENERATOR_H_ |
OLD | NEW |