Module wrappers 

This is responsible for generating the C functions that act as wrappers of the exported Rust functions.

extendr relies on the .Call-interface In short, it is necessary the the signature of the C-function have SEXP as the type for return type, and argument types.

For instance, if your function returns nothing, the return type is not allowed to be void, instead SEXP must be used, and one should return R_NilValue.

R wrappers

Within R, you may call rextendr::document() to generate R functions, that use the .Call-interface, to call the wrapped Rust functions.

You may also manually implement these wrappers, in order to do special type-checking, or other annotation, that could be more convenient to do on the R-side. The C-functions are named according to "{WRAP_PREFIX}{prefix}{mod_name}". See WRAP_PREFIX, and note that prefix is set specifically for methods in extendr-impl blocks, while for functions have no prefix.

Re-exports

use proc_macro2::Ident; 🔒

use quote::format_ident; 🔒

use quote::quote; 🔒

use std::collections::HashMap; 🔒

use std::sync::Mutex; 🔒

use syn::parse_quote; 🔒

use syn::punctuated::Punctuated; 🔒

use syn::Expr; 🔒

use syn::ExprLit; 🔒

use syn::FnArg; 🔒

use syn::ItemFn; 🔒

use syn::Token; 🔒

use syn::Type; 🔒

use crate::extendr_options::ExtendrOptions; 🔒

Structs

STRUCT_DOCS 🔒

Constants

META_PREFIX

WRAP_PREFIX

Functions

get_defaults 🔒

get_doc_string

get_named_lit 🔒

get_return_type

get_struct_doc

Retrieve the struct‐level docs (or empty if none).

make_function_wrappers 🔒

mangled_type_name

register_struct_doc

Called by the struct‐level extendr-macro to register docstrings.

sanitize_identifier 🔒

translate_actual 🔒

translate_formal

translate_meta_arg 🔒

translate_only_alias 🔒

Returns only the alias from a function argument.

translate_to_robj 🔒

Convert SEXP arguments into Robj. This maintains the lifetime of references.

type_name

Return a simplified type name that will be meaningful to R. Defaults to a digest.

type_needs_mut_robj 🔒