Struct CubeclStorageHandle 

pub struct CubeclStorageHandle { /* private fields */ }

Device-resident buffer handle for CubeCL-backed tensors.

Holds:

• A cubecl::server::Handle pointing to GPU memory.
• An Arc<CubeRuntime> so the device client stays alive.
• len: element count (f32 elements).
• ordinal: device ordinal.

This is the concrete type stored inside StorageBuffer::Cubecl for XPU tensors. Constructed by upload_f32.

Implementations

impl CubeclStorageHandle

pub fn from_raw( handle: Handle, runtime: Arc<CubeRuntime>, len: usize, ordinal: usize, ) -> Self

Construct a handle from a raw cubecl::server::Handle returned by a kernel launcher.

Used by ferrotorch-xpu’s wrap_result_handle to turn the (cubecl::server::Handle, shape) pair from portable_* into a CubeclStorageHandle without an extra H2D upload. Issue #673.

pub fn raw_handle(&self) -> &Handle

Borrow the raw cubecl::server::Handle.

Used by ops.rs to pass handles directly to kernel launchers without an extra H2D upload. Issue #673.

pub fn runtime(&self) -> &Arc<CubeRuntime>

Borrow the CubeRuntime this handle belongs to.

Trait Implementations

impl CubeStorageHandle for CubeclStorageHandle

fn as_any(&self) -> &dyn Any

Upcast to &dyn Any for concrete-type downcasting.

fn len(&self) -> usize

Number of f32 elements in the buffer.

fn ordinal(&self) -> usize

Device ordinal this buffer resides on.

fn read_to_host(&self) -> FerrotorchResult<Vec<f32>>

Read the buffer contents back to the host as Vec<f32>.

fn clone_handle(&self) -> Box<dyn CubeStorageHandle>

Clone the handle (allocate a new device buffer with the same contents).

fn is_empty(&self) -> bool

Whether the buffer is empty.

impl Debug for CubeclStorageHandle

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

Formats the value using the given formatter.