Index: src/utils/random-number-generator.h |
diff --git a/src/utils/random-number-generator.h b/src/utils/random-number-generator.h |
new file mode 100644 |
index 0000000000000000000000000000000000000000..fc14ef4ebeb85e6662da27058c5537a8f45ec4c8 |
--- /dev/null |
+++ b/src/utils/random-number-generator.h |
@@ -0,0 +1,106 @@ |
+// Copyright 2013 the V8 project authors. All rights reserved. |
+// Redistribution and use in source and binary forms, with or without |
+// modification, are permitted provided that the following conditions are |
+// met: |
+// |
+// * Redistributions of source code must retain the above copyright |
+// notice, this list of conditions and the following disclaimer. |
+// * Redistributions in binary form must reproduce the above |
+// copyright notice, this list of conditions and the following |
+// disclaimer in the documentation and/or other materials provided |
+// with the distribution. |
+// * Neither the name of Google Inc. nor the names of its |
+// contributors may be used to endorse or promote products derived |
+// from this software without specific prior written permission. |
+// |
+// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
+// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
+// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
+// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
+// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
+// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
+// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
+// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
+// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
+// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
+// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
+ |
+#ifndef V8_UTILS_RANDOM_NUMBER_GENERATOR_H_ |
+#define V8_UTILS_RANDOM_NUMBER_GENERATOR_H_ |
+ |
+#include "globals.h" |
+ |
+namespace v8 { |
+namespace internal { |
+ |
+// ----------------------------------------------------------------------------- |
+// RandomNumberGenerator |
+// |
+// This class is used to generate a stream of pseudorandom numbers. The class |
+// uses a 48-bit seed, which is modified using a linear congruential formula. |
+// (See Donald Knuth, The Art of Computer Programming, Volume 3, Section 3.2.1.) |
+// If two instances of RandomNumberGenerator are created with the same seed, and |
+// the same sequence of method calls is made for each, they will generate and |
+// return identical sequences of numbers. |
+// This class is neither reentrant nor threadsafe. |
+ |
+class RandomNumberGenerator V8_FINAL { |
+ public: |
+ // EntropySource is used as a callback function when V8 needs a source of |
+ // entropy. |
+ typedef bool (*EntropySource)(unsigned char* buffer, size_t buflen); |
+ static void SetEntropySource(EntropySource entropy_source); |
+ |
+ RandomNumberGenerator(); |
+ explicit RandomNumberGenerator(int64_t seed) { SetSeed(seed); } |
+ |
+ // Returns the next pseudorandom, uniformly distributed int value from this |
+ // random number generator's sequence. The general contract of |NextInt()| is |
+ // that one int value is pseudorandomly generated and returned. |
+ // All 2^32 possible integer values are produced with (approximately) equal |
+ // probability. |
+ V8_INLINE(int NextInt()) V8_WARN_UNUSED_RESULT { |
+ return Next(32); |
+ } |
+ |
+ // Returns a pseudorandom, uniformly distributed int value between 0 |
+ // (inclusive) and the specified max value (exclusive), drawn from this random |
+ // number generator's sequence. The general contract of |NextInt(int)| is that |
+ // one int value in the specified range is pseudorandomly generated and |
+ // returned. All max possible int values are produced with (approximately) |
+ // equal probability. |
+ int NextInt(int max) V8_WARN_UNUSED_RESULT; |
+ |
+ // Returns the next pseudorandom, uniformly distributed boolean value from |
+ // this random number generator's sequence. The general contract of |
+ // |NextBoolean()| is that one boolean value is pseudorandomly generated and |
+ // returned. The values true and false are produced with (approximately) equal |
+ // probability. |
+ V8_INLINE(bool NextBool()) V8_WARN_UNUSED_RESULT { |
+ return Next(1) != 0; |
+ } |
+ |
+ // Returns the next pseudorandom, uniformly distributed double value between |
+ // 0.0 and 1.0 from this random number generator's sequence. |
+ // The general contract of |NextDouble()| is that one double value, chosen |
+ // (approximately) uniformly from the range 0.0 (inclusive) to 1.0 |
+ // (exclusive), is pseudorandomly generated and returned. |
+ double NextDouble() V8_WARN_UNUSED_RESULT; |
+ |
+ // Fills the elements of a specified array of bytes with random numbers. |
+ void NextBytes(void* buffer, size_t buflen); |
+ |
+ private: |
+ static const int64_t kMultiplier = V8_2PART_UINT64_C(0x5, deece66d); |
+ static const int64_t kAddend = 0xb; |
+ static const int64_t kMask = V8_2PART_UINT64_C(0xffff, ffffffff); |
+ |
+ int Next(int bits) V8_WARN_UNUSED_RESULT; |
+ void SetSeed(int64_t seed); |
+ |
+ int64_t seed_; |
+}; |
+ |
+} } // namespace v8::internal |
+ |
+#endif // V8_UTILS_RANDOM_NUMBER_GENERATOR_H_ |