1 // Copyright 2012 the V8 project authors. All rights reserved. 2 // Redistribution and use in source and binary forms, with or without 3 // modification, are permitted provided that the following conditions are 4 // met: 5 // 6 // * Redistributions of source code must retain the above copyright 7 // notice, this list of conditions and the following disclaimer. 8 // * Redistributions in binary form must reproduce the above 9 // copyright notice, this list of conditions and the following 10 // disclaimer in the documentation and/or other materials provided 11 // with the distribution. 12 // * Neither the name of Google Inc. nor the names of its 13 // contributors may be used to endorse or promote products derived 14 // from this software without specific prior written permission. 15 // 16 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 17 // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 18 // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 19 // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 20 // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 21 // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 22 // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 23 // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 24 // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 25 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 26 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 27 28 #ifndef V8_UTILS_H_ 29 #define V8_UTILS_H_ 30 31 #include <stdlib.h> 32 #include <string.h> 33 #include <algorithm> 34 #include <climits> 35 36 #include "allocation.h" 37 #include "checks.h" 38 #include "globals.h" 39 40 namespace v8 { 41 namespace internal { 42 43 // ---------------------------------------------------------------------------- 44 // General helper functions 45 46 #define IS_POWER_OF_TWO(x) (((x) & ((x) - 1)) == 0) 47 48 // Returns true iff x is a power of 2 (or zero). Cannot be used with the 49 // maximally negative value of the type T (the -1 overflows). 50 template <typename T> 51 inline bool IsPowerOf2(T x) { 52 return IS_POWER_OF_TWO(x); 53 } 54 55 56 // X must be a power of 2. Returns the number of trailing zeros. 57 inline int WhichPowerOf2(uint32_t x) { 58 ASSERT(IsPowerOf2(x)); 59 ASSERT(x != 0); 60 int bits = 0; 61 #ifdef DEBUG 62 int original_x = x; 63 #endif 64 if (x >= 0x10000) { 65 bits += 16; 66 x >>= 16; 67 } 68 if (x >= 0x100) { 69 bits += 8; 70 x >>= 8; 71 } 72 if (x >= 0x10) { 73 bits += 4; 74 x >>= 4; 75 } 76 switch (x) { 77 default: UNREACHABLE(); 78 case 8: bits++; // Fall through. 79 case 4: bits++; // Fall through. 80 case 2: bits++; // Fall through. 81 case 1: break; 82 } 83 ASSERT_EQ(1 << bits, original_x); 84 return bits; 85 return 0; 86 } 87 88 89 inline int MostSignificantBit(uint32_t x) { 90 static const int msb4[] = {0, 1, 2, 2, 3, 3, 3, 3, 4, 4, 4, 4, 4, 4, 4, 4}; 91 int nibble = 0; 92 if (x & 0xffff0000) { 93 nibble += 16; 94 x >>= 16; 95 } 96 if (x & 0xff00) { 97 nibble += 8; 98 x >>= 8; 99 } 100 if (x & 0xf0) { 101 nibble += 4; 102 x >>= 4; 103 } 104 return nibble + msb4[x]; 105 } 106 107 108 // Magic numbers for integer division. 109 // These are kind of 2's complement reciprocal of the divisors. 110 // Details and proofs can be found in: 111 // - Hacker's Delight, Henry S. Warren, Jr. 112 // - The PowerPC Compiler Writers Guide 113 // and probably many others. 114 // See details in the implementation of the algorithm in 115 // lithium-codegen-arm.cc : LCodeGen::TryEmitSignedIntegerDivisionByConstant(). 116 struct DivMagicNumbers { 117 unsigned M; 118 unsigned s; 119 }; 120 121 const DivMagicNumbers InvalidDivMagicNumber= {0, 0}; 122 const DivMagicNumbers DivMagicNumberFor3 = {0x55555556, 0}; 123 const DivMagicNumbers DivMagicNumberFor5 = {0x66666667, 1}; 124 const DivMagicNumbers DivMagicNumberFor7 = {0x92492493, 2}; 125 const DivMagicNumbers DivMagicNumberFor9 = {0x38e38e39, 1}; 126 const DivMagicNumbers DivMagicNumberFor11 = {0x2e8ba2e9, 1}; 127 const DivMagicNumbers DivMagicNumberFor25 = {0x51eb851f, 3}; 128 const DivMagicNumbers DivMagicNumberFor125 = {0x10624dd3, 3}; 129 const DivMagicNumbers DivMagicNumberFor625 = {0x68db8bad, 8}; 130 131 const DivMagicNumbers DivMagicNumberFor(int32_t divisor); 132 133 134 // The C++ standard leaves the semantics of '>>' undefined for 135 // negative signed operands. Most implementations do the right thing, 136 // though. 137 inline int ArithmeticShiftRight(int x, int s) { 138 return x >> s; 139 } 140 141 142 // Compute the 0-relative offset of some absolute value x of type T. 143 // This allows conversion of Addresses and integral types into 144 // 0-relative int offsets. 145 template <typename T> 146 inline intptr_t OffsetFrom(T x) { 147 return x - static_cast<T>(0); 148 } 149 150 151 // Compute the absolute value of type T for some 0-relative offset x. 152 // This allows conversion of 0-relative int offsets into Addresses and 153 // integral types. 154 template <typename T> 155 inline T AddressFrom(intptr_t x) { 156 return static_cast<T>(static_cast<T>(0) + x); 157 } 158 159 160 // Return the largest multiple of m which is <= x. 161 template <typename T> 162 inline T RoundDown(T x, intptr_t m) { 163 ASSERT(IsPowerOf2(m)); 164 return AddressFrom<T>(OffsetFrom(x) & -m); 165 } 166 167 168 // Return the smallest multiple of m which is >= x. 169 template <typename T> 170 inline T RoundUp(T x, intptr_t m) { 171 return RoundDown<T>(static_cast<T>(x + m - 1), m); 172 } 173 174 175 template <typename T> 176 int Compare(const T& a, const T& b) { 177 if (a == b) 178 return 0; 179 else if (a < b) 180 return -1; 181 else 182 return 1; 183 } 184 185 186 template <typename T> 187 int PointerValueCompare(const T* a, const T* b) { 188 return Compare<T>(*a, *b); 189 } 190 191 192 // Compare function to compare the object pointer value of two 193 // handlified objects. The handles are passed as pointers to the 194 // handles. 195 template<typename T> class Handle; // Forward declaration. 196 template <typename T> 197 int HandleObjectPointerCompare(const Handle<T>* a, const Handle<T>* b) { 198 return Compare<T*>(*(*a), *(*b)); 199 } 200 201 202 // Returns the smallest power of two which is >= x. If you pass in a 203 // number that is already a power of two, it is returned as is. 204 // Implementation is from "Hacker's Delight" by Henry S. Warren, Jr., 205 // figure 3-3, page 48, where the function is called clp2. 206 inline uint32_t RoundUpToPowerOf2(uint32_t x) { 207 ASSERT(x <= 0x80000000u); 208 x = x - 1; 209 x = x | (x >> 1); 210 x = x | (x >> 2); 211 x = x | (x >> 4); 212 x = x | (x >> 8); 213 x = x | (x >> 16); 214 return x + 1; 215 } 216 217 218 inline uint32_t RoundDownToPowerOf2(uint32_t x) { 219 uint32_t rounded_up = RoundUpToPowerOf2(x); 220 if (rounded_up > x) return rounded_up >> 1; 221 return rounded_up; 222 } 223 224 225 template <typename T, typename U> 226 inline bool IsAligned(T value, U alignment) { 227 return (value & (alignment - 1)) == 0; 228 } 229 230 231 // Returns true if (addr + offset) is aligned. 232 inline bool IsAddressAligned(Address addr, 233 intptr_t alignment, 234 int offset = 0) { 235 intptr_t offs = OffsetFrom(addr + offset); 236 return IsAligned(offs, alignment); 237 } 238 239 240 // Returns the maximum of the two parameters. 241 template <typename T> 242 T Max(T a, T b) { 243 return a < b ? b : a; 244 } 245 246 247 // Returns the minimum of the two parameters. 248 template <typename T> 249 T Min(T a, T b) { 250 return a < b ? a : b; 251 } 252 253 254 // Returns the absolute value of its argument. 255 template <typename T> 256 T Abs(T a) { 257 return a < 0 ? -a : a; 258 } 259 260 261 // Returns the negative absolute value of its argument. 262 template <typename T> 263 T NegAbs(T a) { 264 return a < 0 ? a : -a; 265 } 266 267 268 inline int StrLength(const char* string) { 269 size_t length = strlen(string); 270 ASSERT(length == static_cast<size_t>(static_cast<int>(length))); 271 return static_cast<int>(length); 272 } 273 274 275 // ---------------------------------------------------------------------------- 276 // BitField is a help template for encoding and decode bitfield with 277 // unsigned content. 278 279 template<class T, int shift, int size, class U> 280 class BitFieldBase { 281 public: 282 // A type U mask of bit field. To use all bits of a type U of x bits 283 // in a bitfield without compiler warnings we have to compute 2^x 284 // without using a shift count of x in the computation. 285 static const U kOne = static_cast<U>(1U); 286 static const U kMask = ((kOne << shift) << size) - (kOne << shift); 287 static const U kShift = shift; 288 static const U kSize = size; 289 290 // Value for the field with all bits set. 291 static const T kMax = static_cast<T>((1U << size) - 1); 292 293 // Tells whether the provided value fits into the bit field. 294 static bool is_valid(T value) { 295 return (static_cast<U>(value) & ~static_cast<U>(kMax)) == 0; 296 } 297 298 // Returns a type U with the bit field value encoded. 299 static U encode(T value) { 300 ASSERT(is_valid(value)); 301 return static_cast<U>(value) << shift; 302 } 303 304 // Returns a type U with the bit field value updated. 305 static U update(U previous, T value) { 306 return (previous & ~kMask) | encode(value); 307 } 308 309 // Extracts the bit field from the value. 310 static T decode(U value) { 311 return static_cast<T>((value & kMask) >> shift); 312 } 313 }; 314 315 316 template<class T, int shift, int size> 317 class BitField : public BitFieldBase<T, shift, size, uint32_t> { }; 318 319 320 template<class T, int shift, int size> 321 class BitField64 : public BitFieldBase<T, shift, size, uint64_t> { }; 322 323 324 // ---------------------------------------------------------------------------- 325 // Hash function. 326 327 static const uint32_t kZeroHashSeed = 0; 328 329 // Thomas Wang, Integer Hash Functions. 330 // http://www.concentric.net/~Ttwang/tech/inthash.htm 331 inline uint32_t ComputeIntegerHash(uint32_t key, uint32_t seed) { 332 uint32_t hash = key; 333 hash = hash ^ seed; 334 hash = ~hash + (hash << 15); // hash = (hash << 15) - hash - 1; 335 hash = hash ^ (hash >> 12); 336 hash = hash + (hash << 2); 337 hash = hash ^ (hash >> 4); 338 hash = hash * 2057; // hash = (hash + (hash << 3)) + (hash << 11); 339 hash = hash ^ (hash >> 16); 340 return hash; 341 } 342 343 344 inline uint32_t ComputeLongHash(uint64_t key) { 345 uint64_t hash = key; 346 hash = ~hash + (hash << 18); // hash = (hash << 18) - hash - 1; 347 hash = hash ^ (hash >> 31); 348 hash = hash * 21; // hash = (hash + (hash << 2)) + (hash << 4); 349 hash = hash ^ (hash >> 11); 350 hash = hash + (hash << 6); 351 hash = hash ^ (hash >> 22); 352 return static_cast<uint32_t>(hash); 353 } 354 355 356 inline uint32_t ComputePointerHash(void* ptr) { 357 return ComputeIntegerHash( 358 static_cast<uint32_t>(reinterpret_cast<intptr_t>(ptr)), 359 v8::internal::kZeroHashSeed); 360 } 361 362 363 // ---------------------------------------------------------------------------- 364 // Miscellaneous 365 366 // A static resource holds a static instance that can be reserved in 367 // a local scope using an instance of Access. Attempts to re-reserve 368 // the instance will cause an error. 369 template <typename T> 370 class StaticResource { 371 public: 372 StaticResource() : is_reserved_(false) {} 373 374 private: 375 template <typename S> friend class Access; 376 T instance_; 377 bool is_reserved_; 378 }; 379 380 381 // Locally scoped access to a static resource. 382 template <typename T> 383 class Access { 384 public: 385 explicit Access(StaticResource<T>* resource) 386 : resource_(resource) 387 , instance_(&resource->instance_) { 388 ASSERT(!resource->is_reserved_); 389 resource->is_reserved_ = true; 390 } 391 392 ~Access() { 393 resource_->is_reserved_ = false; 394 resource_ = NULL; 395 instance_ = NULL; 396 } 397 398 T* value() { return instance_; } 399 T* operator -> () { return instance_; } 400 401 private: 402 StaticResource<T>* resource_; 403 T* instance_; 404 }; 405 406 407 template <typename T> 408 class Vector { 409 public: 410 Vector() : start_(NULL), length_(0) {} 411 Vector(T* data, int length) : start_(data), length_(length) { 412 ASSERT(length == 0 || (length > 0 && data != NULL)); 413 } 414 415 static Vector<T> New(int length) { 416 return Vector<T>(NewArray<T>(length), length); 417 } 418 419 // Returns a vector using the same backing storage as this one, 420 // spanning from and including 'from', to but not including 'to'. 421 Vector<T> SubVector(int from, int to) { 422 ASSERT(to <= length_); 423 ASSERT(from < to); 424 ASSERT(0 <= from); 425 return Vector<T>(start() + from, to - from); 426 } 427 428 // Returns the length of the vector. 429 int length() const { return length_; } 430 431 // Returns whether or not the vector is empty. 432 bool is_empty() const { return length_ == 0; } 433 434 // Returns the pointer to the start of the data in the vector. 435 T* start() const { return start_; } 436 437 // Access individual vector elements - checks bounds in debug mode. 438 T& operator[](int index) const { 439 ASSERT(0 <= index && index < length_); 440 return start_[index]; 441 } 442 443 const T& at(int index) const { return operator[](index); } 444 445 T& first() { return start_[0]; } 446 447 T& last() { return start_[length_ - 1]; } 448 449 // Returns a clone of this vector with a new backing store. 450 Vector<T> Clone() const { 451 T* result = NewArray<T>(length_); 452 for (int i = 0; i < length_; i++) result[i] = start_[i]; 453 return Vector<T>(result, length_); 454 } 455 456 void Sort(int (*cmp)(const T*, const T*)) { 457 std::sort(start(), start() + length(), RawComparer(cmp)); 458 } 459 460 void Sort() { 461 std::sort(start(), start() + length()); 462 } 463 464 void Truncate(int length) { 465 ASSERT(length <= length_); 466 length_ = length; 467 } 468 469 // Releases the array underlying this vector. Once disposed the 470 // vector is empty. 471 void Dispose() { 472 DeleteArray(start_); 473 start_ = NULL; 474 length_ = 0; 475 } 476 477 inline Vector<T> operator+(int offset) { 478 ASSERT(offset < length_); 479 return Vector<T>(start_ + offset, length_ - offset); 480 } 481 482 // Factory method for creating empty vectors. 483 static Vector<T> empty() { return Vector<T>(NULL, 0); } 484 485 template<typename S> 486 static Vector<T> cast(Vector<S> input) { 487 return Vector<T>(reinterpret_cast<T*>(input.start()), 488 input.length() * sizeof(S) / sizeof(T)); 489 } 490 491 protected: 492 void set_start(T* start) { start_ = start; } 493 494 private: 495 T* start_; 496 int length_; 497 498 class RawComparer { 499 public: 500 explicit RawComparer(int (*cmp)(const T*, const T*)) : cmp_(cmp) {} 501 bool operator()(const T& a, const T& b) { 502 return cmp_(&a, &b) < 0; 503 } 504 505 private: 506 int (*cmp_)(const T*, const T*); 507 }; 508 }; 509 510 511 // A pointer that can only be set once and doesn't allow NULL values. 512 template<typename T> 513 class SetOncePointer { 514 public: 515 SetOncePointer() : pointer_(NULL) { } 516 517 bool is_set() const { return pointer_ != NULL; } 518 519 T* get() const { 520 ASSERT(pointer_ != NULL); 521 return pointer_; 522 } 523 524 void set(T* value) { 525 ASSERT(pointer_ == NULL && value != NULL); 526 pointer_ = value; 527 } 528 529 private: 530 T* pointer_; 531 }; 532 533 534 template <typename T, int kSize> 535 class EmbeddedVector : public Vector<T> { 536 public: 537 EmbeddedVector() : Vector<T>(buffer_, kSize) { } 538 539 explicit EmbeddedVector(T initial_value) : Vector<T>(buffer_, kSize) { 540 for (int i = 0; i < kSize; ++i) { 541 buffer_[i] = initial_value; 542 } 543 } 544 545 // When copying, make underlying Vector to reference our buffer. 546 EmbeddedVector(const EmbeddedVector& rhs) 547 : Vector<T>(rhs) { 548 // TODO(jkummerow): Refactor #includes and use OS::MemCopy() instead. 549 memcpy(buffer_, rhs.buffer_, sizeof(T) * kSize); 550 set_start(buffer_); 551 } 552 553 EmbeddedVector& operator=(const EmbeddedVector& rhs) { 554 if (this == &rhs) return *this; 555 Vector<T>::operator=(rhs); 556 // TODO(jkummerow): Refactor #includes and use OS::MemCopy() instead. 557 memcpy(buffer_, rhs.buffer_, sizeof(T) * kSize); 558 this->set_start(buffer_); 559 return *this; 560 } 561 562 private: 563 T buffer_[kSize]; 564 }; 565 566 567 template <typename T> 568 class ScopedVector : public Vector<T> { 569 public: 570 explicit ScopedVector(int length) : Vector<T>(NewArray<T>(length), length) { } 571 ~ScopedVector() { 572 DeleteArray(this->start()); 573 } 574 575 private: 576 DISALLOW_IMPLICIT_CONSTRUCTORS(ScopedVector); 577 }; 578 579 #define STATIC_ASCII_VECTOR(x) \ 580 v8::internal::Vector<const uint8_t>(reinterpret_cast<const uint8_t*>(x), \ 581 ARRAY_SIZE(x)-1) 582 583 inline Vector<const char> CStrVector(const char* data) { 584 return Vector<const char>(data, StrLength(data)); 585 } 586 587 inline Vector<const uint8_t> OneByteVector(const char* data, int length) { 588 return Vector<const uint8_t>(reinterpret_cast<const uint8_t*>(data), length); 589 } 590 591 inline Vector<const uint8_t> OneByteVector(const char* data) { 592 return OneByteVector(data, StrLength(data)); 593 } 594 595 inline Vector<char> MutableCStrVector(char* data) { 596 return Vector<char>(data, StrLength(data)); 597 } 598 599 inline Vector<char> MutableCStrVector(char* data, int max) { 600 int length = StrLength(data); 601 return Vector<char>(data, (length < max) ? length : max); 602 } 603 604 605 /* 606 * A class that collects values into a backing store. 607 * Specialized versions of the class can allow access to the backing store 608 * in different ways. 609 * There is no guarantee that the backing store is contiguous (and, as a 610 * consequence, no guarantees that consecutively added elements are adjacent 611 * in memory). The collector may move elements unless it has guaranteed not 612 * to. 613 */ 614 template <typename T, int growth_factor = 2, int max_growth = 1 * MB> 615 class Collector { 616 public: 617 explicit Collector(int initial_capacity = kMinCapacity) 618 : index_(0), size_(0) { 619 current_chunk_ = Vector<T>::New(initial_capacity); 620 } 621 622 virtual ~Collector() { 623 // Free backing store (in reverse allocation order). 624 current_chunk_.Dispose(); 625 for (int i = chunks_.length() - 1; i >= 0; i--) { 626 chunks_.at(i).Dispose(); 627 } 628 } 629 630 // Add a single element. 631 inline void Add(T value) { 632 if (index_ >= current_chunk_.length()) { 633 Grow(1); 634 } 635 current_chunk_[index_] = value; 636 index_++; 637 size_++; 638 } 639 640 // Add a block of contiguous elements and return a Vector backed by the 641 // memory area. 642 // A basic Collector will keep this vector valid as long as the Collector 643 // is alive. 644 inline Vector<T> AddBlock(int size, T initial_value) { 645 ASSERT(size > 0); 646 if (size > current_chunk_.length() - index_) { 647 Grow(size); 648 } 649 T* position = current_chunk_.start() + index_; 650 index_ += size; 651 size_ += size; 652 for (int i = 0; i < size; i++) { 653 position[i] = initial_value; 654 } 655 return Vector<T>(position, size); 656 } 657 658 659 // Add a contiguous block of elements and return a vector backed 660 // by the added block. 661 // A basic Collector will keep this vector valid as long as the Collector 662 // is alive. 663 inline Vector<T> AddBlock(Vector<const T> source) { 664 if (source.length() > current_chunk_.length() - index_) { 665 Grow(source.length()); 666 } 667 T* position = current_chunk_.start() + index_; 668 index_ += source.length(); 669 size_ += source.length(); 670 for (int i = 0; i < source.length(); i++) { 671 position[i] = source[i]; 672 } 673 return Vector<T>(position, source.length()); 674 } 675 676 677 // Write the contents of the collector into the provided vector. 678 void WriteTo(Vector<T> destination) { 679 ASSERT(size_ <= destination.length()); 680 int position = 0; 681 for (int i = 0; i < chunks_.length(); i++) { 682 Vector<T> chunk = chunks_.at(i); 683 for (int j = 0; j < chunk.length(); j++) { 684 destination[position] = chunk[j]; 685 position++; 686 } 687 } 688 for (int i = 0; i < index_; i++) { 689 destination[position] = current_chunk_[i]; 690 position++; 691 } 692 } 693 694 // Allocate a single contiguous vector, copy all the collected 695 // elements to the vector, and return it. 696 // The caller is responsible for freeing the memory of the returned 697 // vector (e.g., using Vector::Dispose). 698 Vector<T> ToVector() { 699 Vector<T> new_store = Vector<T>::New(size_); 700 WriteTo(new_store); 701 return new_store; 702 } 703 704 // Resets the collector to be empty. 705 virtual void Reset(); 706 707 // Total number of elements added to collector so far. 708 inline int size() { return size_; } 709 710 protected: 711 static const int kMinCapacity = 16; 712 List<Vector<T> > chunks_; 713 Vector<T> current_chunk_; // Block of memory currently being written into. 714 int index_; // Current index in current chunk. 715 int size_; // Total number of elements in collector. 716 717 // Creates a new current chunk, and stores the old chunk in the chunks_ list. 718 void Grow(int min_capacity) { 719 ASSERT(growth_factor > 1); 720 int new_capacity; 721 int current_length = current_chunk_.length(); 722 if (current_length < kMinCapacity) { 723 // The collector started out as empty. 724 new_capacity = min_capacity * growth_factor; 725 if (new_capacity < kMinCapacity) new_capacity = kMinCapacity; 726 } else { 727 int growth = current_length * (growth_factor - 1); 728 if (growth > max_growth) { 729 growth = max_growth; 730 } 731 new_capacity = current_length + growth; 732 if (new_capacity < min_capacity) { 733 new_capacity = min_capacity + growth; 734 } 735 } 736 NewChunk(new_capacity); 737 ASSERT(index_ + min_capacity <= current_chunk_.length()); 738 } 739 740 // Before replacing the current chunk, give a subclass the option to move 741 // some of the current data into the new chunk. The function may update 742 // the current index_ value to represent data no longer in the current chunk. 743 // Returns the initial index of the new chunk (after copied data). 744 virtual void NewChunk(int new_capacity) { 745 Vector<T> new_chunk = Vector<T>::New(new_capacity); 746 if (index_ > 0) { 747 chunks_.Add(current_chunk_.SubVector(0, index_)); 748 } else { 749 current_chunk_.Dispose(); 750 } 751 current_chunk_ = new_chunk; 752 index_ = 0; 753 } 754 }; 755 756 757 /* 758 * A collector that allows sequences of values to be guaranteed to 759 * stay consecutive. 760 * If the backing store grows while a sequence is active, the current 761 * sequence might be moved, but after the sequence is ended, it will 762 * not move again. 763 * NOTICE: Blocks allocated using Collector::AddBlock(int) can move 764 * as well, if inside an active sequence where another element is added. 765 */ 766 template <typename T, int growth_factor = 2, int max_growth = 1 * MB> 767 class SequenceCollector : public Collector<T, growth_factor, max_growth> { 768 public: 769 explicit SequenceCollector(int initial_capacity) 770 : Collector<T, growth_factor, max_growth>(initial_capacity), 771 sequence_start_(kNoSequence) { } 772 773 virtual ~SequenceCollector() {} 774 775 void StartSequence() { 776 ASSERT(sequence_start_ == kNoSequence); 777 sequence_start_ = this->index_; 778 } 779 780 Vector<T> EndSequence() { 781 ASSERT(sequence_start_ != kNoSequence); 782 int sequence_start = sequence_start_; 783 sequence_start_ = kNoSequence; 784 if (sequence_start == this->index_) return Vector<T>(); 785 return this->current_chunk_.SubVector(sequence_start, this->index_); 786 } 787 788 // Drops the currently added sequence, and all collected elements in it. 789 void DropSequence() { 790 ASSERT(sequence_start_ != kNoSequence); 791 int sequence_length = this->index_ - sequence_start_; 792 this->index_ = sequence_start_; 793 this->size_ -= sequence_length; 794 sequence_start_ = kNoSequence; 795 } 796 797 virtual void Reset() { 798 sequence_start_ = kNoSequence; 799 this->Collector<T, growth_factor, max_growth>::Reset(); 800 } 801 802 private: 803 static const int kNoSequence = -1; 804 int sequence_start_; 805 806 // Move the currently active sequence to the new chunk. 807 virtual void NewChunk(int new_capacity) { 808 if (sequence_start_ == kNoSequence) { 809 // Fall back on default behavior if no sequence has been started. 810 this->Collector<T, growth_factor, max_growth>::NewChunk(new_capacity); 811 return; 812 } 813 int sequence_length = this->index_ - sequence_start_; 814 Vector<T> new_chunk = Vector<T>::New(sequence_length + new_capacity); 815 ASSERT(sequence_length < new_chunk.length()); 816 for (int i = 0; i < sequence_length; i++) { 817 new_chunk[i] = this->current_chunk_[sequence_start_ + i]; 818 } 819 if (sequence_start_ > 0) { 820 this->chunks_.Add(this->current_chunk_.SubVector(0, sequence_start_)); 821 } else { 822 this->current_chunk_.Dispose(); 823 } 824 this->current_chunk_ = new_chunk; 825 this->index_ = sequence_length; 826 sequence_start_ = 0; 827 } 828 }; 829 830 831 // Compare ASCII/16bit chars to ASCII/16bit chars. 832 template <typename lchar, typename rchar> 833 inline int CompareCharsUnsigned(const lchar* lhs, 834 const rchar* rhs, 835 int chars) { 836 const lchar* limit = lhs + chars; 837 #ifdef V8_HOST_CAN_READ_UNALIGNED 838 if (sizeof(*lhs) == sizeof(*rhs)) { 839 // Number of characters in a uintptr_t. 840 static const int kStepSize = sizeof(uintptr_t) / sizeof(*lhs); // NOLINT 841 while (lhs <= limit - kStepSize) { 842 if (*reinterpret_cast<const uintptr_t*>(lhs) != 843 *reinterpret_cast<const uintptr_t*>(rhs)) { 844 break; 845 } 846 lhs += kStepSize; 847 rhs += kStepSize; 848 } 849 } 850 #endif 851 while (lhs < limit) { 852 int r = static_cast<int>(*lhs) - static_cast<int>(*rhs); 853 if (r != 0) return r; 854 ++lhs; 855 ++rhs; 856 } 857 return 0; 858 } 859 860 template<typename lchar, typename rchar> 861 inline int CompareChars(const lchar* lhs, const rchar* rhs, int chars) { 862 ASSERT(sizeof(lchar) <= 2); 863 ASSERT(sizeof(rchar) <= 2); 864 if (sizeof(lchar) == 1) { 865 if (sizeof(rchar) == 1) { 866 return CompareCharsUnsigned(reinterpret_cast<const uint8_t*>(lhs), 867 reinterpret_cast<const uint8_t*>(rhs), 868 chars); 869 } else { 870 return CompareCharsUnsigned(reinterpret_cast<const uint8_t*>(lhs), 871 reinterpret_cast<const uint16_t*>(rhs), 872 chars); 873 } 874 } else { 875 if (sizeof(rchar) == 1) { 876 return CompareCharsUnsigned(reinterpret_cast<const uint16_t*>(lhs), 877 reinterpret_cast<const uint8_t*>(rhs), 878 chars); 879 } else { 880 return CompareCharsUnsigned(reinterpret_cast<const uint16_t*>(lhs), 881 reinterpret_cast<const uint16_t*>(rhs), 882 chars); 883 } 884 } 885 } 886 887 888 // Calculate 10^exponent. 889 inline int TenToThe(int exponent) { 890 ASSERT(exponent <= 9); 891 ASSERT(exponent >= 1); 892 int answer = 10; 893 for (int i = 1; i < exponent; i++) answer *= 10; 894 return answer; 895 } 896 897 898 // The type-based aliasing rule allows the compiler to assume that pointers of 899 // different types (for some definition of different) never alias each other. 900 // Thus the following code does not work: 901 // 902 // float f = foo(); 903 // int fbits = *(int*)(&f); 904 // 905 // The compiler 'knows' that the int pointer can't refer to f since the types 906 // don't match, so the compiler may cache f in a register, leaving random data 907 // in fbits. Using C++ style casts makes no difference, however a pointer to 908 // char data is assumed to alias any other pointer. This is the 'memcpy 909 // exception'. 910 // 911 // Bit_cast uses the memcpy exception to move the bits from a variable of one 912 // type of a variable of another type. Of course the end result is likely to 913 // be implementation dependent. Most compilers (gcc-4.2 and MSVC 2005) 914 // will completely optimize BitCast away. 915 // 916 // There is an additional use for BitCast. 917 // Recent gccs will warn when they see casts that may result in breakage due to 918 // the type-based aliasing rule. If you have checked that there is no breakage 919 // you can use BitCast to cast one pointer type to another. This confuses gcc 920 // enough that it can no longer see that you have cast one pointer type to 921 // another thus avoiding the warning. 922 923 // We need different implementations of BitCast for pointer and non-pointer 924 // values. We use partial specialization of auxiliary struct to work around 925 // issues with template functions overloading. 926 template <class Dest, class Source> 927 struct BitCastHelper { 928 STATIC_ASSERT(sizeof(Dest) == sizeof(Source)); 929 930 INLINE(static Dest cast(const Source& source)) { 931 Dest dest; 932 // TODO(jkummerow): Refactor #includes and use OS::MemCopy() instead. 933 memcpy(&dest, &source, sizeof(dest)); 934 return dest; 935 } 936 }; 937 938 template <class Dest, class Source> 939 struct BitCastHelper<Dest, Source*> { 940 INLINE(static Dest cast(Source* source)) { 941 return BitCastHelper<Dest, uintptr_t>:: 942 cast(reinterpret_cast<uintptr_t>(source)); 943 } 944 }; 945 946 template <class Dest, class Source> 947 INLINE(Dest BitCast(const Source& source)); 948 949 template <class Dest, class Source> 950 inline Dest BitCast(const Source& source) { 951 return BitCastHelper<Dest, Source>::cast(source); 952 } 953 954 955 template<typename ElementType, int NumElements> 956 class EmbeddedContainer { 957 public: 958 EmbeddedContainer() : elems_() { } 959 960 int length() const { return NumElements; } 961 const ElementType& operator[](int i) const { 962 ASSERT(i < length()); 963 return elems_[i]; 964 } 965 ElementType& operator[](int i) { 966 ASSERT(i < length()); 967 return elems_[i]; 968 } 969 970 private: 971 ElementType elems_[NumElements]; 972 }; 973 974 975 template<typename ElementType> 976 class EmbeddedContainer<ElementType, 0> { 977 public: 978 int length() const { return 0; } 979 const ElementType& operator[](int i) const { 980 UNREACHABLE(); 981 static ElementType t = 0; 982 return t; 983 } 984 ElementType& operator[](int i) { 985 UNREACHABLE(); 986 static ElementType t = 0; 987 return t; 988 } 989 }; 990 991 992 // Helper class for building result strings in a character buffer. The 993 // purpose of the class is to use safe operations that checks the 994 // buffer bounds on all operations in debug mode. 995 // This simple base class does not allow formatted output. 996 class SimpleStringBuilder { 997 public: 998 // Create a string builder with a buffer of the given size. The 999 // buffer is allocated through NewArray<char> and must be 1000 // deallocated by the caller of Finalize(). 1001 explicit SimpleStringBuilder(int size); 1002 1003 SimpleStringBuilder(char* buffer, int size) 1004 : buffer_(buffer, size), position_(0) { } 1005 1006 ~SimpleStringBuilder() { if (!is_finalized()) Finalize(); } 1007 1008 int size() const { return buffer_.length(); } 1009 1010 // Get the current position in the builder. 1011 int position() const { 1012 ASSERT(!is_finalized()); 1013 return position_; 1014 } 1015 1016 // Reset the position. 1017 void Reset() { position_ = 0; } 1018 1019 // Add a single character to the builder. It is not allowed to add 1020 // 0-characters; use the Finalize() method to terminate the string 1021 // instead. 1022 void AddCharacter(char c) { 1023 ASSERT(c != '\0'); 1024 ASSERT(!is_finalized() && position_ < buffer_.length()); 1025 buffer_[position_++] = c; 1026 } 1027 1028 // Add an entire string to the builder. Uses strlen() internally to 1029 // compute the length of the input string. 1030 void AddString(const char* s); 1031 1032 // Add the first 'n' characters of the given string 's' to the 1033 // builder. The input string must have enough characters. 1034 void AddSubstring(const char* s, int n); 1035 1036 // Add character padding to the builder. If count is non-positive, 1037 // nothing is added to the builder. 1038 void AddPadding(char c, int count); 1039 1040 // Add the decimal representation of the value. 1041 void AddDecimalInteger(int value); 1042 1043 // Finalize the string by 0-terminating it and returning the buffer. 1044 char* Finalize(); 1045 1046 protected: 1047 Vector<char> buffer_; 1048 int position_; 1049 1050 bool is_finalized() const { return position_ < 0; } 1051 1052 private: 1053 DISALLOW_IMPLICIT_CONSTRUCTORS(SimpleStringBuilder); 1054 }; 1055 1056 1057 // A poor man's version of STL's bitset: A bit set of enums E (without explicit 1058 // values), fitting into an integral type T. 1059 template <class E, class T = int> 1060 class EnumSet { 1061 public: 1062 explicit EnumSet(T bits = 0) : bits_(bits) {} 1063 bool IsEmpty() const { return bits_ == 0; } 1064 bool Contains(E element) const { return (bits_ & Mask(element)) != 0; } 1065 bool ContainsAnyOf(const EnumSet& set) const { 1066 return (bits_ & set.bits_) != 0; 1067 } 1068 void Add(E element) { bits_ |= Mask(element); } 1069 void Add(const EnumSet& set) { bits_ |= set.bits_; } 1070 void Remove(E element) { bits_ &= ~Mask(element); } 1071 void Remove(const EnumSet& set) { bits_ &= ~set.bits_; } 1072 void RemoveAll() { bits_ = 0; } 1073 void Intersect(const EnumSet& set) { bits_ &= set.bits_; } 1074 T ToIntegral() const { return bits_; } 1075 bool operator==(const EnumSet& set) { return bits_ == set.bits_; } 1076 bool operator!=(const EnumSet& set) { return bits_ != set.bits_; } 1077 EnumSet<E, T> operator|(const EnumSet& set) const { 1078 return EnumSet<E, T>(bits_ | set.bits_); 1079 } 1080 1081 private: 1082 T Mask(E element) const { 1083 // The strange typing in ASSERT is necessary to avoid stupid warnings, see: 1084 // http://gcc.gnu.org/bugzilla/show_bug.cgi?id=43680 1085 ASSERT(static_cast<int>(element) < static_cast<int>(sizeof(T) * CHAR_BIT)); 1086 return 1 << element; 1087 } 1088 1089 T bits_; 1090 }; 1091 1092 1093 class TypeFeedbackId { 1094 public: 1095 explicit TypeFeedbackId(int id) : id_(id) { } 1096 int ToInt() const { return id_; } 1097 1098 static TypeFeedbackId None() { return TypeFeedbackId(kNoneId); } 1099 bool IsNone() const { return id_ == kNoneId; } 1100 1101 private: 1102 static const int kNoneId = -1; 1103 1104 int id_; 1105 }; 1106 1107 1108 class BailoutId { 1109 public: 1110 explicit BailoutId(int id) : id_(id) { } 1111 int ToInt() const { return id_; } 1112 1113 static BailoutId None() { return BailoutId(kNoneId); } 1114 static BailoutId FunctionEntry() { return BailoutId(kFunctionEntryId); } 1115 static BailoutId Declarations() { return BailoutId(kDeclarationsId); } 1116 static BailoutId FirstUsable() { return BailoutId(kFirstUsableId); } 1117 static BailoutId StubEntry() { return BailoutId(kStubEntryId); } 1118 1119 bool IsNone() const { return id_ == kNoneId; } 1120 bool operator==(const BailoutId& other) const { return id_ == other.id_; } 1121 1122 private: 1123 static const int kNoneId = -1; 1124 1125 // Using 0 could disguise errors. 1126 static const int kFunctionEntryId = 2; 1127 1128 // This AST id identifies the point after the declarations have been visited. 1129 // We need it to capture the environment effects of declarations that emit 1130 // code (function declarations). 1131 static const int kDeclarationsId = 3; 1132 1133 // Every FunctionState starts with this id. 1134 static const int kFirstUsableId = 4; 1135 1136 // Every compiled stub starts with this id. 1137 static const int kStubEntryId = 5; 1138 1139 int id_; 1140 }; 1141 1142 } } // namespace v8::internal 1143 1144 #endif // V8_UTILS_H_ 1145