v8::EscapableHandleScope Class Reference

A HandleScope which first allocates a handle in the current scope which will be later filled with the escape value. More...

#include <v8.h>

Inheritance diagram for v8::EscapableHandleScope:

Collaboration diagram for v8::EscapableHandleScope:

Public Member Functions
	EscapableHandleScope (Isolate *isolate)
	~EscapableHandleScope ()
template<class T >
Local< T >	Escape (Local< T > value)
	Pushes the value into the previous scope and returns a handle to it. More...
Public Member Functions inherited from v8::HandleScope
	HandleScope (Isolate *isolate)
	~HandleScope ()
Isolate *	GetIsolate () const

Private Member Functions
internal::Object **	Escape (internal::Object **escape_value)
	EscapableHandleScope (const EscapableHandleScope &)
void	operator= (const EscapableHandleScope &)
void *	operator new (size_t size)
void	operator delete (void *, size_t)

Private Attributes
internal::Object **	escape_slot_

Additional Inherited Members
Static Public Member Functions inherited from v8::HandleScope
static int	NumberOfHandles (Isolate *isolate)
	Counts the number of allocated handles. More...
Protected Member Functions inherited from v8::HandleScope
	HandleScope ()
void	Initialize (Isolate *isolate)
Static Protected Member Functions inherited from v8::HandleScope
static internal::Object **	CreateHandle (internal::Isolate *isolate, internal::Object *value)

Detailed Description

A HandleScope which first allocates a handle in the current scope which will be later filled with the escape value.

Definition at line 855 of file v8.h.

Constructor & Destructor Documentation

EscapableHandleScope() [1/2]

v8::EscapableHandleScope::EscapableHandleScope

(

Isolate *

isolate

)

Definition at line 591 of file api.cc.

                                                              {
  i::Isolate* isolate = reinterpret_cast<i::Isolate*>(v8_isolate);
  escape_slot_ = CreateHandle(isolate, isolate->heap()->the_hole_value());
  Initialize(v8_isolate);
}

References v8::HandleScope::CreateHandle(), escape_slot_, v8::internal::Isolate::heap(), and v8::HandleScope::Initialize().

Here is the call graph for this function:

~EscapableHandleScope()

v8::EscapableHandleScope::~EscapableHandleScope ( )

inline

Definition at line 858 of file v8.h.

{}

EscapableHandleScope() [2/2]

v8::EscapableHandleScope::EscapableHandleScope ( const EscapableHandleScope &  )

private

Member Function Documentation

Escape() [1/2]

i::Object ** v8::EscapableHandleScope::Escape ( internal::Object **  escape_value )

private

Definition at line 598 of file api.cc.

                                                             {
  i::Heap* heap = reinterpret_cast<i::Isolate*>(GetIsolate())->heap();
  Utils::ApiCheck(*escape_slot_ == heap->the_hole_value(),
                  "EscapeableHandleScope::Escape",
                  "Escape value set twice");
  if (escape_value == NULL) {
    *escape_slot_ = heap->undefined_value();
    return NULL;
  }
  *escape_slot_ = *escape_value;
  return escape_slot_;
}

References v8::Utils::ApiCheck(), escape_slot_, v8::HandleScope::GetIsolate(), and NULL.

Here is the call graph for this function:

Escape() [2/2]

template<class T >

Local<T> v8::EscapableHandleScope::Escape ( Local< T >  value )

inline

Pushes the value into the previous scope and returns a handle to it.

Cannot be called twice.

Definition at line 865 of file v8.h.

                                            {
    internal::Object** slot =
        Escape(reinterpret_cast<internal::Object**>(*value));
    return Local<T>(reinterpret_cast<T*>(slot));
  }

References T.

Referenced by v8::Shell::CreateEvaluationContext(), v8::Shell::DebugCommandToJSONRequest(), v8::Shell::DebugMessageDetails(), v8::internal::Handle< T >::EscapeFrom(), v8::Message::Get(), v8::Shell::GetCompletions(), v8::StackTrace::GetFrame(), v8::internal::MessageImpl::GetJSON(), v8::Debug::GetMirror(), v8::Message::GetSourceLine(), v8::Message::GetStackTrace(), v8::getStringProperty(), and v8::Function::NewInstance().

Here is the caller graph for this function:

operator delete()

void v8::EscapableHandleScope::operator delete ( void *  , size_t    )

private

operator new()

void* v8::EscapableHandleScope::operator new ( size_t  size )

private

operator=()

void v8::EscapableHandleScope::operator= ( const EscapableHandleScope &  )

private

Member Data Documentation

escape_slot_

internal::Object** v8::EscapableHandleScope::escape_slot_

private

Definition at line 881 of file v8.h.

Referenced by EscapableHandleScope(), and Escape().

---

The documentation for this class was generated from the following files:

• /mnt/V8SourceCode/include/v8.h
• /mnt/V8SourceCode/src/api.cc