Struct OwnedProtect 

pub struct OwnedProtect {
    sexp: SEXP,
    armed: bool,
    _nosend: PhantomData<Rc<()>>,
}

A single-object RAII guard: PROTECT on create, UNPROTECT(1) on drop.

Use this for simple cases where you’re protecting a single value and don’t need the batching benefits of ProtectScope.

Example

unsafe fn allocate_and_fill() -> SEXP {
    let guard = OwnedProtect::new(Rf_allocVector(REALSXP, 10));
    fill_vector(guard.get());
    // Return the SEXP - guard drops and unprotects on this line.
    // This is safe because no GC can occur between unprotect and return.
    guard.get()
}

Warning: Stack Ordering

OwnedProtect uses UNPROTECT(1), which removes the top of the protection stack. If you have nested protections from other sources, the drop order matters!

For complex scenarios, prefer ProtectScope which unprotects all its values at once when dropped.

Fields

sexp: SEXP

armed: bool

_nosend: PhantomData<Rc<()>>

Implementations

impl OwnedProtect

pub unsafe fn new(x: SEXP) -> Self

Create a new protection guard for x.

Calls Rf_protect(x) immediately.

Safety

• Must be called from the R main thread
• x must be a valid SEXP

pub fn get(&self) -> SEXP

Get the protected SEXP.

pub unsafe fn forget(self)

Escape hatch: do not UNPROTECT(1) on drop.

Safety

Leaks one protection entry unless unprotected elsewhere.

Trait Implementations

impl Deref for OwnedProtect

type Target = SEXP

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl Drop for OwnedProtect

fn drop(&mut self)

Executes the destructor for this type.