PersistentBase< T > Class Template Reference

#include <v8.h>

Inheritance diagram for PersistentBase< T >:

Public Member Functions
V8_INLINE void	Reset ()
template<class S >
V8_INLINE void	Reset (Isolate *isolate, const Local< S > &other)
template<class S >
V8_INLINE void	Reset (Isolate *isolate, const PersistentBase< S > &other)
V8_INLINE bool	IsEmpty () const
V8_INLINE void	Empty ()
V8_INLINE Local< T >	Get (Isolate *isolate) const
template<class S >
V8_INLINE bool	operator== (const PersistentBase< S > &that) const
template<class S >
V8_INLINE bool	operator== (const Local< S > &that) const
template<class S >
V8_INLINE bool	operator!= (const PersistentBase< S > &that) const
template<class S >
V8_INLINE bool	operator!= (const Local< S > &that) const
template<typename P >
V8_INLINE	V8_DEPRECATED ("use WeakCallbackInfo version", void SetWeak(P *parameter, typename WeakCallbackData< T, P >::Callback callback))
template<typename S , typename P >
V8_INLINE	V8_DEPRECATED ("use WeakCallbackInfo version", void SetWeak(P *parameter, typename WeakCallbackData< S, P >::Callback callback))
template<typename P >
V8_INLINE	V8_DEPRECATED ("use SetWeak", void SetPhantom(P *parameter, typename WeakCallbackInfo< P >::Callback callback, int internal_field_index1=-1, int internal_field_index2=-1))
template<typename P >
V8_INLINE void	SetWeak (P *parameter, typename WeakCallbackInfo< P >::Callback callback, WeakCallbackType type)
template<typename P >
V8_INLINE P *	ClearWeak ()
V8_INLINE void	ClearWeak ()
V8_INLINE void	RegisterExternalReference (Isolate *isolate)
V8_INLINE void	MarkIndependent ()
V8_INLINE void	MarkPartiallyDependent ()
V8_INLINE void	MarkActive ()
V8_INLINE bool	IsIndependent () const
V8_INLINE bool	IsNearDeath () const
V8_INLINE bool	IsWeak () const
V8_INLINE void	SetWrapperClassId (uint16_t class_id)
V8_INLINE uint16_t	WrapperClassId () const
template<class S >
void	Reset (Isolate *isolate, const Local< S > &other)
template<class S >
void	Reset (Isolate *isolate, const PersistentBase< S > &other)
template<typename P >
void	SetWeak (P *parameter, typename WeakCallbackData< T, P >::Callback callback)

Friends
class	Isolate
class	Utils
template<class F >
class	Local
template<class F1 , class F2 >
class	Persistent
template<class F >
class	Global
template<class F >
class	PersistentBase
template<class F >
class	ReturnValue
template<class F1 , class F2 , class F3 >
class	PersistentValueMapBase
template<class F1 , class F2 >
class	PersistentValueVector
class	Object

Detailed Description

template<class T>
class v8::PersistentBase< T >

An object reference that is independent of any handle scope. Where a Local handle only lives as long as the HandleScope in which it was allocated, a PersistentBase handle remains valid until it is explicitly disposed.

A persistent handle contains a reference to a storage cell within the v8 engine which holds an object value and which is updated by the garbage collector whenever the object is moved. A new storage cell can be created using the constructor or PersistentBase::Reset and existing handles can be disposed using PersistentBase::Reset.

Definition at line 498 of file v8.h.

Member Function Documentation

ClearWeak() [1/2]

V8_INLINE P* ClearWeak

(

)

ClearWeak() [2/2]

P * ClearWeak ( )

inline

Definition at line 596 of file v8.h.

Empty()

V8_INLINE void Empty ( )

inline

Definition at line 520 of file v8.h.

Get()

V8_INLINE Local<T> Get ( Isolate *  isolate ) const

inline

Definition at line 522 of file v8.h.

References Local< T >::Local.

IsEmpty()

V8_INLINE bool IsEmpty ( ) const

inline

Definition at line 519 of file v8.h.

Referenced by PersistentBase< T >::RegisterExternalReference().

IsIndependent()

bool IsIndependent

Definition at line 7552 of file v8.h.

References Internals::GetNodeFlag(), and Internals::kNodeIsIndependentShift.

IsNearDeath()

bool IsNearDeath

Checks if the handle holds the only reference to an object.

Definition at line 7561 of file v8.h.

References Internals::GetNodeState(), Internals::kNodeStateIsNearDeathValue, and Internals::kNodeStateIsPendingValue.

IsWeak()

bool IsWeak

Returns true if the handle's reference is weak.

Definition at line 7572 of file v8.h.

References Internals::GetNodeState(), and Internals::kNodeStateIsWeakValue.

MarkActive()

void MarkActive

Marks the reference to this object as active. The scavenge garbage collection should not reclaim the objects marked as active. This bit is cleared after the each garbage collection pass.

Definition at line 7689 of file v8.h.

References Internals::kNodeIsActiveShift, and Internals::UpdateNodeFlag().

MarkIndependent()

void MarkIndependent

Marks the reference to this object independent. Garbage collector is free to ignore any object groups containing this object. Weak callback for an independent handle should not assume that it will be preceded by a global GC prologue callback or followed by a global GC epilogue callback.

Definition at line 7669 of file v8.h.

References Internals::kNodeIsIndependentShift, and Internals::UpdateNodeFlag().

MarkPartiallyDependent()

void MarkPartiallyDependent

Marks the reference to this object partially dependent. Partially dependent handles only depend on other partially dependent handles and these dependencies are provided through object groups. It provides a way to build smaller object groups for young objects that represent only a subset of all external dependencies. This mark is automatically cleared after each garbage collection.

Definition at line 7679 of file v8.h.

References Internals::kNodeIsPartiallyDependentShift, and Internals::UpdateNodeFlag().

operator!=() [1/2]

V8_INLINE bool operator!= ( const Local< S > &  that ) const

inline

Definition at line 550 of file v8.h.

operator!=() [2/2]

V8_INLINE bool operator!= ( const PersistentBase< S > &  that ) const

inline

Definition at line 545 of file v8.h.

operator==() [1/2]

V8_INLINE bool operator== ( const Local< S > &  that ) const

inline

Definition at line 536 of file v8.h.

operator==() [2/2]

V8_INLINE bool operator== ( const PersistentBase< S > &  that ) const

inline

Definition at line 527 of file v8.h.

RegisterExternalReference()

void RegisterExternalReference

(

Isolate *

isolate

)

Allows the embedder to tell the v8 garbage collector that a certain object is alive. Only allowed when the embedder is asked to trace its heap by EmbedderHeapTracer.

Definition at line 7661 of file v8.h.

References PersistentBase< T >::IsEmpty().

Reset() [1/5]

void Reset

If non-empty, destroy the underlying storage cell IsEmpty() will return true after this call.

Definition at line 7581 of file v8.h.

Reset() [2/5]

V8_INLINE void Reset	(	Isolate *	isolate,
		const Local< S > &	other
	)

If non-empty, destroy the underlying storage cell and create a new one with the contents of other if other is non empty

Reset() [3/5]

void Reset	(	Isolate *	isolate,
		const Local< S > &	other
	)

Definition at line 7590 of file v8.h.

Reset() [4/5]

V8_INLINE void Reset	(	Isolate *	isolate,
		const PersistentBase< S > &	other
	)

If non-empty, destroy the underlying storage cell and create a new one with the contents of other if other is non empty

Reset() [5/5]

void Reset	(	Isolate *	isolate,
		const PersistentBase< S > &	other
	)

Definition at line 7600 of file v8.h.

SetWeak() [1/2]

void SetWeak	(	P *	parameter,
		typename WeakCallbackData< T, P >::Callback	callback
	)

Definition at line 7623 of file v8.h.

SetWeak() [2/2]

V8_INLINE void SetWeak	(	P *	parameter,
		typename WeakCallbackInfo< P >::Callback	callback,
		WeakCallbackType	type
	)

Definition at line 7611 of file v8.h.

SetWrapperClassId()

void SetWrapperClassId

(

uint16_t

class_id

)

Assigns a wrapper class ID to the handle. See RetainedObjectInfo interface description in v8-profiler.h for details.

Definition at line 7698 of file v8.h.

References Internals::kNodeClassIdOffset.

V8_DEPRECATED() [1/3]

V8_INLINE V8_DEPRECATED	(	"use SetWeak"	,
		void	SetPhantomP *parameter, typename WeakCallbackInfo< P >::Callback callback, int internal_field_index1=-1, int internal_field_index2=-1
	)

V8_DEPRECATED() [2/3]

V8_INLINE V8_DEPRECATED	(	"use WeakCallbackInfo version"	,
		void	SetWeakP *parameter, typename WeakCallbackData< S, P >::Callback callback
	)

V8_DEPRECATED() [3/3]

V8_INLINE V8_DEPRECATED	(	"use WeakCallbackInfo version"	,
		void	SetWeakP *parameter, typename WeakCallbackData< T, P >::Callback callback
	)

Install a finalization callback on this object. NOTE: There is no guarantee as to when or even if the callback is invoked. The invocation is performed solely on a best effort basis. As always, GC-based finalization should not be relied upon for any critical form of resource management!

WrapperClassId()

uint16_t WrapperClassId

Returns the class ID previously assigned to this handle or 0 if no class ID was previously assigned.

Definition at line 7708 of file v8.h.

References Internals::kNodeClassIdOffset.

Friends And Related Function Documentation

Global

friend class Global

friend

Definition at line 656 of file v8.h.

Referenced by PersistentValueVector< V, Traits >::Append(), PersistentValueVector< V, Traits >::Clear(), Global< T >::Pass(), PersistentValueMapBase< K, V, Traits >::Release(), PersistentValueMapBase< K, V, Traits >::RemoveWeak(), PersistentValueMap< K, V, Traits >::Set(), and GlobalValueMap< K, V, Traits >::Set().

Isolate

friend class Isolate

friend

Definition at line 651 of file v8.h.

Local

friend class Local

friend

Definition at line 653 of file v8.h.

Object

friend class Object

friend

Definition at line 662 of file v8.h.

Persistent

friend class Persistent

friend

Definition at line 654 of file v8.h.

PersistentBase

friend class PersistentBase

friend

Definition at line 657 of file v8.h.

PersistentValueMapBase

friend class PersistentValueMapBase

friend

Definition at line 660 of file v8.h.

PersistentValueVector

friend class PersistentValueVector

friend

Definition at line 661 of file v8.h.

ReturnValue

friend class ReturnValue

friend

Definition at line 658 of file v8.h.

Referenced by FunctionCallbackInfo< T >::GetReturnValue(), and PropertyCallbackInfo< T >::GetReturnValue().

Utils

friend class Utils

friend

Definition at line 652 of file v8.h.

---

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

• include/v8.h