v8  10.1.124 (node 18.2.0)
V8 is Google's open source JavaScript engine
TracedReference< T > Class Template Reference

#include <v8-traced-handle.h>

Inheritance diagram for TracedReference< T >:
Collaboration diagram for TracedReference< T >:

Public Member Functions

 TracedReference ()
 
template<class S >
 TracedReference (Isolate *isolate, Local< S > that)
 
V8_INLINE TracedReference (TracedReference &&other) noexcept
 
template<typename S >
V8_INLINE TracedReference (TracedReference< S > &&other) noexcept
 
V8_INLINE TracedReference (const TracedReference &other)
 
template<typename S >
V8_INLINE TracedReference (const TracedReference< S > &other)
 
V8_INLINE TracedReferenceoperator= (TracedReference &&rhs) noexcept
 
template<class S >
V8_INLINE TracedReferenceoperator= (TracedReference< S > &&rhs) noexcept
 
V8_INLINE TracedReferenceoperator= (const TracedReference &rhs)
 
template<class S >
V8_INLINE TracedReferenceoperator= (const TracedReference< S > &rhs)
 
template<class S >
V8_INLINE void Reset (Isolate *isolate, const Local< S > &other)
 
template<class S >
V8_INLINE TracedReference< S > & As () const
 
template<class S >
void Reset (Isolate *isolate, const Local< S > &other)
 
template<class S >
TracedReference< T > & operator= (TracedReference< S > &&rhs) noexcept
 
template<class S >
TracedReference< T > & operator= (const TracedReference< S > &rhs)
 
- Public Member Functions inherited from BasicTracedReference< T >
Local< T > Get (Isolate *isolate) const
 
template<class S >
V8_INLINE BasicTracedReference< S > & As () const
 
T * operator-> () const
 
T * operator* () const
 
- Public Member Functions inherited from TracedReferenceBase
bool IsEmpty () const
 
V8_INLINE void Reset ()
 
V8_INLINE v8::Local< v8::ValueGet (v8::Isolate *isolate) const
 
bool IsEmptyThreadSafe () const
 
V8_INLINE void SetWrapperClassId (uint16_t class_id)
 
V8_INLINE uint16_t WrapperClassId () const
 

Additional Inherited Members

- Protected Member Functions inherited from TracedReferenceBase
void SetSlotThreadSafe (void *new_val)
 
const void * GetSlotThreadSafe () const
 
V8_EXPORT void CheckValue () const
 
- Protected Attributes inherited from TracedReferenceBase
internal::Addressval_ = nullptr
 

Detailed Description

template<typename T>
class v8::TracedReference< T >

A traced handle without destructor that clears the handle. The embedder needs to ensure that the handle is not accessed once the V8 object has been reclaimed. This can happen when the handle is not passed through the EmbedderHeapTracer. For more details see BasicTracedReference.

The reference assumes the embedder has precise knowledge about references at all times. In case V8 needs to separately handle on-stack references, the embedder is required to set the stack start through |EmbedderHeapTracer::SetStackStart|.

Definition at line 349 of file v8-traced-handle.h.

Constructor & Destructor Documentation

◆ TracedReference() [1/6]

TracedReference ( )
inline

An empty TracedReference without storage cell.

Definition at line 356 of file v8-traced-handle.h.

References Local< T >::BasicTracedReference.

◆ TracedReference() [2/6]

TracedReference ( Isolate isolate,
Local< S >  that 
)
inline

Construct a TracedReference from a Local.

When the Local is non-empty, a new storage cell is created pointing to the same object.

Definition at line 365 of file v8-traced-handle.h.

References Local< T >::BasicTracedReference, v8::internal::kInitializingStore, and v8::internal::kWithoutDestructor.

◆ TracedReference() [3/6]

V8_INLINE TracedReference ( TracedReference< T > &&  other)
inlinenoexcept

Move constructor initializing TracedReference from an existing one.

Definition at line 377 of file v8-traced-handle.h.

◆ TracedReference() [4/6]

V8_INLINE TracedReference ( TracedReference< S > &&  other)
inlinenoexcept

Move constructor initializing TracedReference from an existing one.

Definition at line 387 of file v8-traced-handle.h.

◆ TracedReference() [5/6]

V8_INLINE TracedReference ( const TracedReference< T > &  other)
inline

Copy constructor initializing TracedReference from an existing one.

Definition at line 396 of file v8-traced-handle.h.

◆ TracedReference() [6/6]

V8_INLINE TracedReference ( const TracedReference< S > &  other)
inline

Copy constructor initializing TracedReference from an existing one.

Definition at line 406 of file v8-traced-handle.h.

Member Function Documentation

◆ As()

V8_INLINE TracedReference<S>& As ( ) const
inline

Definition at line 441 of file v8-traced-handle.h.

References Local< T >::TracedReference.

◆ operator=() [1/6]

TracedReference< T > & operator= ( const TracedReference< T > &  rhs)

Copy assignment operator initializing TracedGlobal from an existing one.

Definition at line 550 of file v8-traced-handle.h.

References v8::internal::CopyTracedGlobalReference().

◆ operator=() [2/6]

V8_INLINE TracedReference& operator= ( const TracedReference< S > &  rhs)

Copy assignment operator initializing TracedGlobal from an existing one.

◆ operator=() [3/6]

TracedReference<T>& operator= ( const TracedReference< S > &  rhs)

Definition at line 531 of file v8-traced-handle.h.

◆ operator=() [4/6]

TracedReference< T > & operator= ( TracedReference< T > &&  rhs)
noexcept

Move assignment operator initializing TracedGlobal from an existing one.

Definition at line 539 of file v8-traced-handle.h.

References v8::internal::MoveTracedGlobalReference().

◆ operator=() [5/6]

V8_INLINE TracedReference& operator= ( TracedReference< S > &&  rhs)
noexcept

Move assignment operator initializing TracedGlobal from an existing one.

◆ operator=() [6/6]

TracedReference<T>& operator= ( TracedReference< S > &&  rhs)
noexcept

Definition at line 522 of file v8-traced-handle.h.

◆ Reset() [1/2]

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() [2/2]

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

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