handles.h revision d0582a6c46733687d045e4188a1bcd0123c758a1
1a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// Copyright 2006-2008 the V8 project authors. All rights reserved. 2a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// Redistribution and use in source and binary forms, with or without 3a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// modification, are permitted provided that the following conditions are 4a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// met: 5a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// 6a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// * Redistributions of source code must retain the above copyright 7a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// notice, this list of conditions and the following disclaimer. 8a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// * Redistributions in binary form must reproduce the above 9a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// copyright notice, this list of conditions and the following 10a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// disclaimer in the documentation and/or other materials provided 11a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// with the distribution. 12a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// * Neither the name of Google Inc. nor the names of its 13a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// contributors may be used to endorse or promote products derived 14a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// from this software without specific prior written permission. 15a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// 16a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 17a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 18a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 19a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 20a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 21a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 22a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 23a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 24a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 25a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 26a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 27a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 28a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block#ifndef V8_HANDLES_H_ 29a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block#define V8_HANDLES_H_ 30a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 31a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block#include "apiutils.h" 32a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 33a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blocknamespace v8 { 34a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blocknamespace internal { 35a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 36a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// ---------------------------------------------------------------------------- 37a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// A Handle provides a reference to an object that survives relocation by 38a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// the garbage collector. 39a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// Handles are only valid within a HandleScope. 40a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// When a handle is created for an object a cell is allocated in the heap. 41a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 42a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blocktemplate<class T> 43a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockclass Handle { 44a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block public: 45a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block INLINE(Handle(T** location)) { location_ = location; } 46a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block INLINE(explicit Handle(T* obj)); 47a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 48a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block INLINE(Handle()) : location_(NULL) {} 49a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 50a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block // Constructor for handling automatic up casting. 51a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block // Ex. Handle<JSFunction> can be passed when Handle<Object> is expected. 52a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block template <class S> Handle(Handle<S> handle) { 53a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block#ifdef DEBUG 54a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block T* a = NULL; 55a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block S* b = NULL; 56a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block a = b; // Fake assignment to enforce type checks. 57a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block USE(a); 58a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block#endif 59a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block location_ = reinterpret_cast<T**>(handle.location()); 60a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block } 61a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 62a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block INLINE(T* operator ->() const) { return operator*(); } 63a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 64a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block // Check if this handle refers to the exact same object as the other handle. 65a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block bool is_identical_to(const Handle<T> other) const { 66a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block return operator*() == *other; 67a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block } 68a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 69a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block // Provides the C++ dereference operator. 70a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block INLINE(T* operator*() const); 71a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 72a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block // Returns the address to where the raw pointer is stored. 73a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block T** location() const { 74a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block ASSERT(location_ == NULL || 75a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block reinterpret_cast<Address>(*location_) != kZapValue); 76a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block return location_; 77a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block } 78a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 79a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block template <class S> static Handle<T> cast(Handle<S> that) { 80a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block T::cast(*that); 81a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block return Handle<T>(reinterpret_cast<T**>(that.location())); 82a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block } 83a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 84a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block static Handle<T> null() { return Handle<T>(); } 85a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block bool is_null() { return location_ == NULL; } 86a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 87a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block // Closes the given scope, but lets this handle escape. See 88a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block // implementation in api.h. 89a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block inline Handle<T> EscapeFrom(v8::HandleScope* scope); 90a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 91a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block private: 92a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block T** location_; 93a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block}; 94a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 95a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 96a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// A stack-allocated class that governs a number of local handles. 97a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// After a handle scope has been created, all local handles will be 98a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// allocated within that handle scope until either the handle scope is 99a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// deleted or another handle scope is created. If there is already a 100a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// handle scope and a new one is created, all allocations will take 101a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// place in the new handle scope until it is deleted. After that, 102a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// new handles will again be allocated in the original handle scope. 103a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// 104a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// After the handle scope of a local handle has been deleted the 105a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// garbage collector will no longer track the object stored in the 106a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// handle and may deallocate it. The behavior of accessing a handle 107a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// for which the handle scope has been deleted is undefined. 108a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockclass HandleScope { 109a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block public: 110a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block HandleScope() : previous_(current_) { 111a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block current_.extensions = 0; 112a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block } 113a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 114a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block ~HandleScope() { 115a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Leave(&previous_); 116a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block } 117a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 118a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block // Counts the number of allocated handles. 119a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block static int NumberOfHandles(); 120a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 121a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block // Creates a new handle with the given value. 122a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block template <typename T> 123a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block static inline T** CreateHandle(T* value) { 124a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block internal::Object** cur = current_.next; 125a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block if (cur == current_.limit) cur = Extend(); 126a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block // Update the current next field, set the value in the created 127a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block // handle, and return the result. 128a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block ASSERT(cur < current_.limit); 129a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block current_.next = cur + 1; 130a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 131a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block T** result = reinterpret_cast<T**>(cur); 132a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block *result = value; 133a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block return result; 134a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block } 135a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 136d0582a6c46733687d045e4188a1bcd0123c758a1Steve Block // Deallocates any extensions used by the current scope. 137d0582a6c46733687d045e4188a1bcd0123c758a1Steve Block static void DeleteExtensions(); 138d0582a6c46733687d045e4188a1bcd0123c758a1Steve Block 139d0582a6c46733687d045e4188a1bcd0123c758a1Steve Block static Address current_extensions_address(); 140d0582a6c46733687d045e4188a1bcd0123c758a1Steve Block static Address current_next_address(); 141d0582a6c46733687d045e4188a1bcd0123c758a1Steve Block static Address current_limit_address(); 142d0582a6c46733687d045e4188a1bcd0123c758a1Steve Block 143a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block private: 144a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block // Prevent heap allocation or illegal handle scopes. 145a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block HandleScope(const HandleScope&); 146a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block void operator=(const HandleScope&); 147a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block void* operator new(size_t size); 148a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block void operator delete(void* size_t); 149a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 150a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block static v8::ImplementationUtilities::HandleScopeData current_; 151a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block const v8::ImplementationUtilities::HandleScopeData previous_; 152a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 153a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block // Pushes a fresh handle scope to be used when allocating new handles. 154a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block static void Enter( 155a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block v8::ImplementationUtilities::HandleScopeData* previous) { 156a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block *previous = current_; 157a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block current_.extensions = 0; 158a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block } 159a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 160a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block // Re-establishes the previous scope state. Should be called only 161a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block // once, and only for the current scope. 162a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block static void Leave( 163a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block const v8::ImplementationUtilities::HandleScopeData* previous) { 164a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block if (current_.extensions > 0) { 165a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block DeleteExtensions(); 166a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block } 167a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block current_ = *previous; 168a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block#ifdef DEBUG 169a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block ZapRange(current_.next, current_.limit); 170a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block#endif 171a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block } 172a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 173a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block // Extend the handle scope making room for more handles. 174a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block static internal::Object** Extend(); 175a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 176a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block // Zaps the handles in the half-open interval [start, end). 177a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block static void ZapRange(internal::Object** start, internal::Object** end); 178a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 179a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block friend class v8::HandleScope; 180a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block friend class v8::ImplementationUtilities; 181a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block}; 182a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 183a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 184a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// ---------------------------------------------------------------------------- 185a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// Handle operations. 186a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// They might invoke garbage collection. The result is an handle to 187a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// an object of expected type, or the handle is an error if running out 188a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// of space or encountering an internal error. 189a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 190a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockvoid NormalizeProperties(Handle<JSObject> object, 191a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block PropertyNormalizationMode mode, 192a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block int expected_additional_properties); 193a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockvoid NormalizeElements(Handle<JSObject> object); 194a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockvoid TransformToFastProperties(Handle<JSObject> object, 195a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block int unused_property_fields); 196a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockvoid FlattenString(Handle<String> str); 197a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 198a7e24c173cf37484693b9abb38e494fa7bd7baebSteve BlockHandle<Object> SetProperty(Handle<JSObject> object, 199a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Handle<String> key, 200a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Handle<Object> value, 201a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block PropertyAttributes attributes); 202a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 203a7e24c173cf37484693b9abb38e494fa7bd7baebSteve BlockHandle<Object> SetProperty(Handle<Object> object, 204a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Handle<Object> key, 205a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Handle<Object> value, 206a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block PropertyAttributes attributes); 207a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 208a7e24c173cf37484693b9abb38e494fa7bd7baebSteve BlockHandle<Object> ForceSetProperty(Handle<JSObject> object, 209a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Handle<Object> key, 210a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Handle<Object> value, 211a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block PropertyAttributes attributes); 212a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 213a7e24c173cf37484693b9abb38e494fa7bd7baebSteve BlockHandle<Object> ForceDeleteProperty(Handle<JSObject> object, 214a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Handle<Object> key); 215a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 216a7e24c173cf37484693b9abb38e494fa7bd7baebSteve BlockHandle<Object> IgnoreAttributesAndSetLocalProperty(Handle<JSObject> object, 217a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Handle<String> key, 218a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Handle<Object> value, 219a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block PropertyAttributes attributes); 220a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 221a7e24c173cf37484693b9abb38e494fa7bd7baebSteve BlockHandle<Object> SetPropertyWithInterceptor(Handle<JSObject> object, 222a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Handle<String> key, 223a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Handle<Object> value, 224a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block PropertyAttributes attributes); 225a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 226a7e24c173cf37484693b9abb38e494fa7bd7baebSteve BlockHandle<Object> SetElement(Handle<JSObject> object, 227a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block uint32_t index, 228a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Handle<Object> value); 229a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 230a7e24c173cf37484693b9abb38e494fa7bd7baebSteve BlockHandle<Object> GetProperty(Handle<JSObject> obj, 231a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block const char* name); 232a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 233a7e24c173cf37484693b9abb38e494fa7bd7baebSteve BlockHandle<Object> GetProperty(Handle<Object> obj, 234a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Handle<Object> key); 235a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 236a7e24c173cf37484693b9abb38e494fa7bd7baebSteve BlockHandle<Object> GetPropertyWithInterceptor(Handle<JSObject> receiver, 237a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Handle<JSObject> holder, 238a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Handle<String> name, 239a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block PropertyAttributes* attributes); 240a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 241a7e24c173cf37484693b9abb38e494fa7bd7baebSteve BlockHandle<Object> GetPrototype(Handle<Object> obj); 242a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 243a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// Return the object's hidden properties object. If the object has no hidden 244a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// properties and create_if_needed is true, then a new hidden property object 245a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// will be allocated. Otherwise the Heap::undefined_value is returned. 246a7e24c173cf37484693b9abb38e494fa7bd7baebSteve BlockHandle<Object> GetHiddenProperties(Handle<JSObject> obj, bool create_if_needed); 247a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 248a7e24c173cf37484693b9abb38e494fa7bd7baebSteve BlockHandle<Object> DeleteElement(Handle<JSObject> obj, uint32_t index); 249a7e24c173cf37484693b9abb38e494fa7bd7baebSteve BlockHandle<Object> DeleteProperty(Handle<JSObject> obj, Handle<String> prop); 250a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 251a7e24c173cf37484693b9abb38e494fa7bd7baebSteve BlockHandle<Object> LookupSingleCharacterStringFromCode(uint32_t index); 252a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 253a7e24c173cf37484693b9abb38e494fa7bd7baebSteve BlockHandle<JSObject> Copy(Handle<JSObject> obj); 254a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 255a7e24c173cf37484693b9abb38e494fa7bd7baebSteve BlockHandle<FixedArray> AddKeysFromJSArray(Handle<FixedArray>, 256a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Handle<JSArray> array); 257a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 258a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// Get the JS object corresponding to the given script; create it 259a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// if none exists. 260a7e24c173cf37484693b9abb38e494fa7bd7baebSteve BlockHandle<JSValue> GetScriptWrapper(Handle<Script> script); 261a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 262a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// Script line number computations. 263a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockvoid InitScriptLineEnds(Handle<Script> script); 264a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockint GetScriptLineNumber(Handle<Script> script, int code_position); 265a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 266a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// Computes the enumerable keys from interceptors. Used for debug mirrors and 267a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// by GetKeysInFixedArrayFor below. 268a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockv8::Handle<v8::Array> GetKeysForNamedInterceptor(Handle<JSObject> receiver, 269a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Handle<JSObject> object); 270a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockv8::Handle<v8::Array> GetKeysForIndexedInterceptor(Handle<JSObject> receiver, 271a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Handle<JSObject> object); 272a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 273a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockenum KeyCollectionType { LOCAL_ONLY, INCLUDE_PROTOS }; 274a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 275a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// Computes the enumerable keys for a JSObject. Used for implementing 276a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// "for (n in object) { }". 277a7e24c173cf37484693b9abb38e494fa7bd7baebSteve BlockHandle<FixedArray> GetKeysInFixedArrayFor(Handle<JSObject> object, 278a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block KeyCollectionType type); 279a7e24c173cf37484693b9abb38e494fa7bd7baebSteve BlockHandle<JSArray> GetKeysFor(Handle<JSObject> object); 280d0582a6c46733687d045e4188a1bcd0123c758a1Steve BlockHandle<FixedArray> GetEnumPropertyKeys(Handle<JSObject> object, 281d0582a6c46733687d045e4188a1bcd0123c758a1Steve Block bool cache_result); 282a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 283a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// Computes the union of keys and return the result. 284a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// Used for implementing "for (n in object) { }" 285a7e24c173cf37484693b9abb38e494fa7bd7baebSteve BlockHandle<FixedArray> UnionOfKeys(Handle<FixedArray> first, 286a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Handle<FixedArray> second); 287a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 288a7e24c173cf37484693b9abb38e494fa7bd7baebSteve BlockHandle<String> SubString(Handle<String> str, int start, int end); 289a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 290a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 291a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// Sets the expected number of properties for the function's instances. 292a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockvoid SetExpectedNofProperties(Handle<JSFunction> func, int nof); 293a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 294a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// Sets the prototype property for a function instance. 295a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockvoid SetPrototypeProperty(Handle<JSFunction> func, Handle<JSObject> value); 296a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 297a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// Sets the expected number of properties based on estimate from compiler. 298a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockvoid SetExpectedNofPropertiesFromEstimate(Handle<SharedFunctionInfo> shared, 299a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block int estimate); 300a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockvoid SetExpectedNofPropertiesFromEstimate(Handle<JSFunction> func, 301a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block int estimate); 302a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 303a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 304a7e24c173cf37484693b9abb38e494fa7bd7baebSteve BlockHandle<JSGlobalProxy> ReinitializeJSGlobalProxy( 305a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Handle<JSFunction> constructor, 306a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Handle<JSGlobalProxy> global); 307a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 308a7e24c173cf37484693b9abb38e494fa7bd7baebSteve BlockHandle<Object> SetPrototype(Handle<JSFunction> function, 309a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Handle<Object> prototype); 310a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 311a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 312d0582a6c46733687d045e4188a1bcd0123c758a1Steve Block// Does lazy compilation of the given function. Returns true on success and 313d0582a6c46733687d045e4188a1bcd0123c758a1Steve Block// false if the compilation resulted in a stack overflow. 314a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockenum ClearExceptionFlag { KEEP_EXCEPTION, CLEAR_EXCEPTION }; 315a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 316a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockbool CompileLazyShared(Handle<SharedFunctionInfo> shared, 317a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block ClearExceptionFlag flag, 318a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block int loop_nesting); 319a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 320a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockbool CompileLazy(Handle<JSFunction> function, ClearExceptionFlag flag); 321a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockbool CompileLazyInLoop(Handle<JSFunction> function, ClearExceptionFlag flag); 322a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 323d0582a6c46733687d045e4188a1bcd0123c758a1Steve Block// Returns the lazy compilation stub for argc arguments. 324d0582a6c46733687d045e4188a1bcd0123c758a1Steve BlockHandle<Code> ComputeLazyCompile(int argc); 325d0582a6c46733687d045e4188a1bcd0123c758a1Steve Block 326a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// These deal with lazily loaded properties. 327a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockvoid SetupLazy(Handle<JSObject> obj, 328a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block int index, 329a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Handle<Context> compile_context, 330a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Handle<Context> function_context); 331a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockvoid LoadLazy(Handle<JSObject> obj, bool* pending_exception); 332a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 333a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockclass NoHandleAllocation BASE_EMBEDDED { 334a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block public: 335a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block#ifndef DEBUG 336a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block NoHandleAllocation() {} 337a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block ~NoHandleAllocation() {} 338a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block#else 339a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block inline NoHandleAllocation(); 340a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block inline ~NoHandleAllocation(); 341a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block private: 342a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block int extensions_; 343a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block#endif 344a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block}; 345a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 346a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 347a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// ---------------------------------------------------------------------------- 348a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 349a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 350a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// Stack allocated wrapper call for optimizing adding multiple 351a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// properties to an object. 352a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockclass OptimizedObjectForAddingMultipleProperties BASE_EMBEDDED { 353a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block public: 354a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block OptimizedObjectForAddingMultipleProperties(Handle<JSObject> object, 355a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block int expected_property_count, 356a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block bool condition = true); 357a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block ~OptimizedObjectForAddingMultipleProperties(); 358a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block private: 359a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block bool has_been_transformed_; // Tells whether the object has been transformed. 360a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block int unused_property_fields_; // Captures the unused number of field. 361a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Handle<JSObject> object_; // The object being optimized. 362a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block}; 363a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 364a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 365a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block} } // namespace v8::internal 366a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 367a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block#endif // V8_HANDLES_H_ 368