Struct DotCallBuilder 

pub struct DotCallBuilder {
    c_ident: String,
    self_var: Option<String>,
    args: Vec<String>,
    call_expr: Option<String>,
}

Builder for formatting .Call() invocations in R wrapper code.

Handles the common pattern of .Call(C_ident, .call = sys.call(), args...).

Example

let call = DotCallBuilder::new("C_Counter__increment")
    .with_self("self")
    .build();
// => ".Call(C_Counter__increment, .call = sys.call(), self)"

let call = DotCallBuilder::new("C_Counter__add")
    .with_self("x")
    .with_args(&["n"])
    .build();
// => ".Call(C_Counter__add, .call = sys.call(), x, n)"

Fields

c_ident: String

The C entry point symbol name (e.g., "C_Counter__increment"). This is the first argument to .Call().

self_var: Option<String>

Optional self/receiver variable name (e.g., "self", "x"). When present, prepended before other arguments in the .Call() invocation.

args: Vec<String>

Additional argument names passed after self (if any) in the .Call() invocation.

call_expr: Option<String>

Expression for the .call named argument. None means sys.call() (the default). Set via DotCallBuilder::null_call_attribution to emit .call = NULL instead.

Implementations

impl DotCallBuilder

pub fn new(c_ident: impl Into<String>) -> Self

Create a new builder with the C function identifier.

pub fn with_self(self, var: impl Into<String>) -> Self

Add a self/x parameter (prepended to args).

pub fn with_args(self, args: &[impl AsRef<str>]) -> Self

Add arguments after self (if any).

pub fn with_args_str(self, args: &str) -> Self

Add a pre-joined argument string (e.g., "x, y") as a single emit unit.

Empty strings are ignored, so callers can pass the result of build_r_call_args_from_sig directly without a length check.

pub fn null_call_attribution(self) -> Self

Pass .call = NULL instead of .call = sys.call(): for the R6 / S7 lambda frames, which R6 / S7 dispatch calls (R6 finalizer / deep_clone, S7 property getter / setter / validator), where sys.call() names an internal dispatch frame instead of the user’s call. Not reachable from any attribute. With NULL, the raise helper’s fallback (a NULL .val$call takes .call_default, the sys.call() in condition_check_lines; only a call-less condition’s FALSE marker gives NULL) surfaces the nearest meaningful frame instead.

pub fn with_call_attribution(self, attribution: CallAttribution) -> Self

Pass the .call of attribution (CallAttribution::dot_call_expr): environment() for a generated S3 method (CallAttribution::Generic, #1851), which the raise helper turns into the generic’s call when a condition is raised.

pub fn build(&self) -> String

Build the .Call() string.

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: 96 bytes