Struct Handle 

pub(crate) struct Handle<'a, T>
where
    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<Value>>

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

pub fn len(&self) -> u32

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

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, 'cx, 'r>(&'s self, _no_gc: &'cx NoGC) -> &'r T

where 's: 'r, 'cx: 'r, '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) -> Handle<'a, T>

pub unsafe fn from_raw(handle: Handle<T>) -> Handle<'a, T>

impl Handle<'static, Value>

pub fn null() -> Handle<'static, Value>

pub fn undefined() -> Handle<'static, Value>

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

pub fn null() -> Handle<'a, *mut JSObject>

Trait Implementations

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

fn clone(&self) -> Handle<'_, T>

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) -> Handle<T>

Convert this object to a handle.

impl<'a> ToJSValConvertible for Handle<'a, Value>

unsafe fn to_jsval(&self, cx: *mut JSContext, rval: MutableHandle<'_, Value>)

Convert self to a JSVal. JSAPI failure causes a panic.

fn safe_to_jsval(&self, cx: &mut JSContext, rval: MutableHandle<'_, Value>)

Convert self to a JSVal. JSAPI failure causes a panic.

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