Struct Handle 

pub struct Handle<'a, T: 'a> {
    pub(crate) ptr: NonNull<T>,
    pub(crate) _phantom: PhantomData<&'a T>,
}

Fields

ptr: NonNull<T>

_phantom: PhantomData<&'a T>

Implementations

impl<'a> Handle<'a, StackGCVector<JSVal, TempAllocPolicy>>

pub fn at(&'a self, index: u32) -> Option<Handle<'a, JSVal>>

pub fn len(&self) -> u32

impl<'a> Handle<'a, StackGCVector<*mut JSString, TempAllocPolicy>>

pub fn at(&'a self, index: u32) -> Option<Handle<'a, *mut JSString>>

pub fn len(&self) -> u32

impl<'a, T> Handle<'a, T>

pub fn get(&self) -> T

where T: Copy,

pub fn as_ref<'s: 'r, 'cx: 'r, 'r>(&'s self, _no_gc: &'cx NoGC) -> &'r T

where 'a: 's,

Obtains a reference to the value pointed to by this handle. While this reference is alive, no GC can occur, because of the _no_gc argument:

use mozjs::context::*;
use mozjs::jsapi::JSObject;
use mozjs::rooted;


fn gc(cx: &mut JSContext) {}

fn f(cx: &mut JSContext, obj: *mut JSObject) {
    rooted!(&in(cx) let mut root = obj);
    let handle = root.handle();
    let r = handle.as_ref(cx);
    gc(cx); // cannot call gc while r (thus cx borrow) is alive
    drop(r); // otherwise rust automatically drops r before gc call
}

pub unsafe fn from_marked_location(ptr: *const T) -> Self

pub unsafe fn from_raw(handle: RawHandle<T>) -> Self

impl Handle<'static, Value>

pub fn null() -> Self

pub fn undefined() -> Self

impl<'a> Handle<'a, *mut JSObject>

pub fn null() -> Self

Trait Implementations

impl<T> Clone for Handle<'_, T>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a, T> Deref for Handle<'a, T>

fn deref(&self) -> &T

This is unsound and will be removed eventually. Use Handle::as_ref instead.

type Target = T

The resulting type after dereferencing.

impl<'a, T> IntoHandle for Handle<'a, T>

type Target = T

The type of the handle

fn into_handle(self) -> RawHandle<T>

Convert this object to a handle.

impl<T> Copy for Handle<'_, T>