v8::MaybeLocal< T > Class Template Reference

#include <v8-local-handle.h>

Collaboration diagram for v8::MaybeLocal< T >:

Public Member Functions
V8_INLINE	MaybeLocal ()=default
template<class S > requires std::is_base_of_v<T, S>
V8_INLINE	MaybeLocal (Local< S > that)
template<class S > requires std::is_base_of_v<T, S>
V8_INLINE	MaybeLocal (MaybeLocal< S > that)
V8_INLINE bool	IsEmpty () const
template<class S >
V8_WARN_UNUSED_RESULT V8_INLINE bool	ToLocal (Local< S > *out) const
V8_INLINE Local< T >	ToLocalChecked ()
template<class S >
V8_INLINE Local< S >	FromMaybe (Local< S > default_value) const
template<class S >
V8_INLINE MaybeLocal< S >	As () const

Static Public Member Functions
template<class S >
static V8_INLINE MaybeLocal< T >	Cast (MaybeLocal< S > that)

Private Attributes
Local< T >	local_

Friends
template<typename S >
class	MaybeLocal

Detailed Description

template<class T>
class v8::MaybeLocal< T >

A MaybeLocal<> is a wrapper around Local<> that enforces a check whether the Local<> is empty before it can be used.

If an API method returns a MaybeLocal<>, the API method can potentially fail either because an exception is thrown, or because an exception is pending, e.g. because a previous API call threw an exception that hasn't been caught yet, or because a TerminateExecution exception was thrown. In that case, an empty MaybeLocal is returned.

Definition at line 635 of file v8-local-handle.h.

Constructor & Destructor Documentation

MaybeLocal() [1/3]

template<class T >

V8_INLINE v8::MaybeLocal< T >::MaybeLocal ( )

default

Default constructor: Returns an empty handle.

MaybeLocal() [2/3]

template<class T >

template<class S >
requires std::is_base_of_v<T, S>

V8_INLINE v8::MaybeLocal< T >::MaybeLocal ( Local< S > that )

inline

Implicitly construct MaybeLocal from Local.

Definition at line 646 of file v8-local-handle.h.

MaybeLocal() [3/3]

template<class T >

template<class S >
requires std::is_base_of_v<T, S>

V8_INLINE v8::MaybeLocal< T >::MaybeLocal ( MaybeLocal< S > that )

inline

Implicitly up-cast MaybeLocal to MaybeLocal<T> if T is a base of S.

Definition at line 652 of file v8-local-handle.h.

Member Function Documentation

As()

template<class T >

template<class S >

V8_INLINE MaybeLocal< S > v8::MaybeLocal< T >::As ( ) const

inline

Calling this is equivalent to MaybeLocal<S>::Cast(). In particular, this is only valid if the handle actually refers to a value of the target type or if the handle is empty.

Definition at line 700 of file v8-local-handle.h.

Here is the call graph for this function:

Cast()

template<class T >

template<class S >

static V8_INLINE MaybeLocal< T > v8::MaybeLocal< T >::Cast ( MaybeLocal< S > that )

inlinestatic

Cast a handle to a subclass, e.g. MaybeLocal<Value> to MaybeLocal<Object>. This is only valid if the handle actually refers to a value of the target type or if the handle is empty.

Definition at line 690 of file v8-local-handle.h.

Here is the call graph for this function:

Here is the caller graph for this function:

FromMaybe()

template<class T >

template<class S >

V8_INLINE Local< S > v8::MaybeLocal< T >::FromMaybe ( Local< S > default_value ) const

inline

Converts this MaybeLocal<> to a Local<>, using a default value if this MaybeLocal<> is empty.

Definition at line 680 of file v8-local-handle.h.

Here is the call graph for this function:

IsEmpty()

template<class T >

V8_INLINE bool v8::MaybeLocal< T >::IsEmpty ( ) const

inline

Definition at line 654 of file v8-local-handle.h.

Here is the caller graph for this function:

ToLocal()

template<class T >

template<class S >

V8_WARN_UNUSED_RESULT V8_INLINE bool v8::MaybeLocal< T >::ToLocal ( Local< S > * out ) const

inline

Converts this MaybeLocal<> to a Local<>. If this MaybeLocal<> is empty, |false| is returned and |out| is assigned with nullptr.

Definition at line 661 of file v8-local-handle.h.

Here is the call graph for this function:

Here is the caller graph for this function:

ToLocalChecked()

template<class T >

V8_INLINE Local< T > v8::MaybeLocal< T >::ToLocalChecked ( )

inline

Converts this MaybeLocal<> to a Local<>. If this MaybeLocal<> is empty, V8 will crash the process.

Definition at line 670 of file v8-local-handle.h.

Here is the call graph for this function:

Here is the caller graph for this function:

Friends And Related Symbol Documentation

MaybeLocal

template<class T >

template<typename S >

friend class MaybeLocal

friend

Definition at line 708 of file v8-local-handle.h.

Member Data Documentation

local_

template<class T >

Local<T> v8::MaybeLocal< T >::local_

private

Definition at line 705 of file v8-local-handle.h.

---

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

• include/v8-local-handle.h