Struct ArgBuilder 

pub struct ArgBuilder { /* private fields */ }

A builder for constructing named kernel argument arrays.

Collects typed argument values along with their names, then produces the Vec<*mut c_void> array needed by cuLaunchKernel.

Example

use oxicuda_launch::named_args::ArgBuilder;

let x: f32 = 3.14;
let n: u32 = 512;
let mut builder = ArgBuilder::new();
builder.add("x", &x).add("n", &n);
assert_eq!(builder.arg_count(), 2);
let ptrs = builder.build();
assert_eq!(ptrs.len(), 2);

Implementations

impl ArgBuilder

pub fn new() -> Self

Creates a new empty argument builder.

pub fn with_capacity(capacity: usize) -> Self

Creates a new argument builder with the given initial capacity.

pub fn add<T: Copy>(&mut self, name: &str, val: &T) -> &mut Self

Adds a named argument to the builder.

The pointer to val is stored. The caller must ensure that val remains valid (not moved or dropped) until the kernel launch using the built pointer array completes.

Returns &mut Self for method chaining.

pub fn build(self) -> Vec<*mut c_void>

Builds the argument pointer array for cuLaunchKernel.

Returns the raw pointer array. The names are consumed; use names before calling build if you need them.

pub fn names(&self) -> Vec<&str>

Returns the names of all added arguments in order.

pub fn arg_count(&self) -> usize

Returns the number of arguments added so far.

pub fn is_empty(&self) -> bool

Returns true if no arguments have been added.

pub fn summary(&self) -> String

Returns a human-readable summary of the arguments.

Trait Implementations

impl Debug for ArgBuilder

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

Formats the value using the given formatter.

impl Default for ArgBuilder

fn default() -> Self

Returns the “default value” for a type.