Skip to main content

FixedNamedArgs

Struct FixedNamedArgs 

Source
pub struct FixedNamedArgs<const N: usize> { /* private fields */ }
Expand description

A const-generic, stack-allocated array of named kernel arguments.

FixedNamedArgs<N> stores exactly N NamedArgEntry values on the stack — zero heap allocation, zero indirection overhead compared to a plain positional tuple.

§Invariants

Every pointed-to value must remain valid (not moved or dropped) until after the kernel launch that consumes this struct completes.

§Example

use oxicuda_launch::named_args::{FixedNamedArgs, NamedArgEntry};

let n: u32 = 1024;
let alpha: f32 = 2.0;

let args = FixedNamedArgs::new([
    NamedArgEntry { name: "n",     ptr: &n     as *const u32 as *const std::ffi::c_void },
    NamedArgEntry { name: "alpha", ptr: &alpha as *const f32  as *const std::ffi::c_void },
]);

assert_eq!(args.len(), 2);
assert_eq!(args.names()[0], "n");
assert_eq!(args.names()[1], "alpha");

Implementations§

Source§

impl<const N: usize> FixedNamedArgs<N>

Source

pub const fn new(entries: [NamedArgEntry; N]) -> Self

Creates a new FixedNamedArgs from an array of NamedArgEntry values.

Source

pub const fn len(&self) -> usize

Returns the number of arguments.

Source

pub const fn is_empty(&self) -> bool

Returns true if there are no arguments.

Source

pub fn names(&self) -> [&'static str; N]

Returns the argument names in declaration order.

Source

pub fn as_ptr_array(&self) -> [*mut c_void; N]

Returns a mutable array of *mut c_void pointers suitable for passing directly to cuLaunchKernel as the kernelParams array.

§Safety

The returned pointers are valid only as long as the original values that were passed when constructing the entries remain in scope.

Source

pub fn entries(&self) -> &[NamedArgEntry; N]

Returns an immutable slice over the entries for inspection.

Trait Implementations§

Source§

impl<const N: usize> Debug for FixedNamedArgs<N>

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

§

impl<const N: usize> Freeze for FixedNamedArgs<N>

§

impl<const N: usize> RefUnwindSafe for FixedNamedArgs<N>

§

impl<const N: usize> Send for FixedNamedArgs<N>

§

impl<const N: usize> Sync for FixedNamedArgs<N>

§

impl<const N: usize> Unpin for FixedNamedArgs<N>

§

impl<const N: usize> UnsafeUnpin for FixedNamedArgs<N>

§

impl<const N: usize> UnwindSafe for FixedNamedArgs<N>

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more