Enum ReturnHandling 

pub enum ReturnHandling {
    Unit,
    RawSexp,
    ExternalPtr,
    IntoR,
    OptionUnit,
    OptionSexp,
    OptionIntoR,
    OptionIntoRUnwrap,
    ResultUnit,
    ResultSexp,
    ResultIntoR,
    ResultNullOnErr,
    AsListOf,
    AsExternalPtrOf,
    AsNativeOf,
}

Strategy for converting a Rust return value into an R SEXP.

Determined automatically by detect_return_handling from the function’s return type, or set explicitly via CWrapperContextBuilder::return_handling. Each variant handles a different return type pattern, controlling how the C wrapper converts the Rust value back to R and how errors/None values are surfaced.

Variants

Unit

Returns unit type () – emits R_NilValue.

RawSexp

Returns raw SEXP – passes the value through unchanged (no conversion).

ExternalPtr

Returns Self – wraps the value in an ExternalPtr via ExternalPtr::new.

IntoR

Returns an arbitrary type T: IntoR – converts via IntoR::into_sexp.

OptionUnit

Returns Option<()> – raises an error on None, otherwise emits R_NilValue.

OptionSexp

Returns Option<SEXP> – raises an error on None, otherwise passes through.

OptionIntoR

Returns Option<T> where Option<T>: IntoR – calls IntoR::into_sexp on the whole Option value. Suitable when the type has a direct impl IntoR for Option<T> (e.g., Option<&T>, Option<Vec<T>>, Option<i32>). None maps to whatever the IntoR impl returns (typically NULL or NA).

Use this variant explicitly via CWrapperContextBuilder::return_handling when the type has a direct IntoR impl for the whole Option. The auto-detector detect_return_handling conservatively returns [OptionIntoRUnwrap] instead since it cannot resolve trait impls at macro expansion time.

OptionIntoRUnwrap

Returns Option<T> where T: IntoR – unwraps the option first, then converts the inner value via IntoR::into_sexp. Raises an error on None. Suitable when T: IntoR but Option<T> doesn’t have a direct IntoR impl (e.g., Option<SomeExternalPtr>).

ResultUnit

Returns Result<(), E> – raises an error on Err, otherwise emits R_NilValue.

ResultSexp

Returns Result<SEXP, E> – raises an error on Err, otherwise passes through.

ResultIntoR

Returns Result<T, E> – raises an error on Err, otherwise converts via IntoR::into_sexp.

ResultNullOnErr

Returns Result<T, ()> – maps Err(()) to Err(NullOnErr) then converts via IntoR. None/Err maps to R NULL (unit error is a deliberate sentinel, not a Rust failure).

AsListOf

Returns T where T: IntoList – wraps in AsList(result) then calls IntoR::into_sexp.

Produced when #[miniextendr(prefer = "list")] is used on a function returning T: IntoList. Distinct from returning AsList<T> explicitly only in that the wrapping is generated by the macro rather than written by the user.

AsExternalPtrOf

Returns T where T: IntoExternalPtr – wraps in AsExternalPtr(result) then calls IntoR::into_sexp.

Produced when #[miniextendr(prefer = "externalptr")] is used on a function returning T: IntoExternalPtr. Distinct from the existing ExternalPtr variant (which boxes Self via ExternalPtr::new): this variant calls IntoExternalPtr::into_external_ptr() on T.

AsNativeOf

Returns T where T: RNativeType – wraps in AsRNative(result) then calls IntoR::into_sexp.

Produced when #[miniextendr(prefer = "native")] is used on a function returning T: RNativeType.

Trait Implementations

impl Clone for ReturnHandling

fn clone(&self) -> ReturnHandling

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ReturnHandling

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

Formats the value using the given formatter.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 1 byte

Size for each variant:

• Unit: 0 bytes
• RawSexp: 0 bytes
• ExternalPtr: 0 bytes
• IntoR: 0 bytes
• OptionUnit: 0 bytes
• OptionSexp: 0 bytes
• OptionIntoR: 0 bytes
• OptionIntoRUnwrap: 0 bytes
• ResultUnit: 0 bytes
• ResultSexp: 0 bytes
• ResultIntoR: 0 bytes
• ResultNullOnErr: 0 bytes
• AsListOf: 0 bytes
• AsExternalPtrOf: 0 bytes
• AsNativeOf: 0 bytes