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 = match.call(), args...).

Example

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

let call = DotCallBuilder::new("C_Counter__add")
    .with_self("x")
    .with_args(&["n"])
    .build();
// => ".Call(C_Counter__add, .call = match.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 match.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 = match.call().

Use for lambda dispatch sites (R6 finalizer/deep_clone, S7 property getter/setter/validator) where match.call() captures an internal dispatch frame instead of the user’s call. With NULL, the if (is.null(.val$call)) .call_default else .val$call fallback in condition_check_lines surfaces the nearest meaningful frame instead.

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