Struct RefGuard 

pub struct RefGuard<T: Rc> { /* private fields */ }

A smart pointer for types from cef library.

Implementations

impl<T: Rc> RefGuard<T>

pub unsafe fn from_raw(ptr: *mut T) -> RefGuard<T>

Create RefGuard from a raw C pointer.

Safety

This should be used to get the return value of the FFI function. This means we get the ownership of the value. The reference count of the return value is already increased when you get it. So we don’t need to increase it again manually. Using this method elsewhere may cause incorrect reference count and memory safety issues.

pub unsafe fn from_raw_add_ref(ptr: *mut T) -> RefGuard<T>

Create RefGuard from a raw C pointer and increase a reference count. This should be used when you want to copy the value and create another wrapper type.

Safety

THis should be used when you want to manually increase the reference count upon getting the raw pointer. Using this method elsewhere may cause incorrect reference count and memory safety issues.

pub unsafe fn into_raw(&self) -> *mut T

Safety

This should be used when you need to pass wrapper type to the FFI function as parameter, and it is the self type (usually the first parameter). This means we pass the ownership of the value to the function call. Using this method elsewhere may cause incorrect reference count and memory safety issues.

pub unsafe fn convert<U: Rc>(&self) -> RefGuard<U>

Convert the value to another value that is also reference counted.

Safety

This should be used when the type has type U as its base type. Using this method elsewhere may cause memory safety issues.

Trait Implementations

impl<T: Rc> Clone for RefGuard<T>

fn clone(&self) -> RefGuard<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> ConvertParam<*mut T> for &RefGuard<T>

where T: Sized + Rc,

fn into_raw(self) -> *mut T

Access the RefGuard and return the raw pointer without decreasing the reference count.

Safety

This should be used when you need to pass wrapper type to the FFI function as parameter, and it is not the self type (usually the first parameter). This means we pass the ownership of the value to the function call. Using this method elsewehre may cause incorrect reference count and memory safety issues.

impl<T: Debug + Rc> Debug for RefGuard<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T: Rc> Deref for RefGuard<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &T

Dereferences the value.

impl<T: Rc> Drop for RefGuard<T>

fn drop(&mut self)

Executes the destructor for this type.

impl<T: Rc> Send for RefGuard<T>

impl<T: Rc> Sync for RefGuard<T>