#[doc(hidden)]pub unsafe fn sidecar_r_cached<T: TypedExternal>(
x: SEXP,
index: usize,
convert: impl FnOnce(&T) -> Result<SEXP, SEXP>,
) -> SEXPExpand description
The R getter of the #[r_data(cache)] field at cache index index
(#2271): the R value an earlier read stored for the live T the receiver
x carries, else the value of convert on it, stored for later reads
when it is Ok. An Err is the tagged condition of a failed conversion,
returned as is and not stored.
The value is borrowed shared, as sidecar_r_struct borrows it, before
the stored value is looked up, so a read while a running call holds the
value mutably raises miniextendr_borrow_conflict whether or not a value
is stored, and a pointer without a live T is refused the same way. Every
exclusive borrow of the value drops what is stored
(borrow_value_mut); see the field_cache
module for what stays unseen.
§Safety
Must be called from R’s main thread with a valid x.