Struct BackendId

pub struct BackendId { /* private fields */ }

Stable provider identifier for logs and explicit selection.

Identity is stored inline as fixed-capacity UTF-8 rather than &'static str, because accelerator backends (CUDA, HIP, Vulkan) enumerate their devices at runtime and cannot produce 'static text without leaking. Keeping the value inline preserves Copy, so BackendId can continue to live inside GeomError variants and DevicePreference without forcing an allocation or a lifetime onto the error type.

Implementations

impl BackendId

pub const CAPACITY: usize = 47usize

Maximum identifier length in bytes.

pub const fn new(value: &str) -> Self

Construct an identifier known at compile time.

Panics

Panics if value exceeds BackendId::CAPACITY bytes. This is a const fn, so an over-long literal fails the build rather than a test run. Use BackendId::try_new for runtime-derived text.

pub fn try_new(value: &str) -> Result<Self, BackendIdTooLong>

Construct an identifier from runtime-derived text, such as a driver-enumerated device name.

Errors

Returns BackendIdTooLong when the text exceeds BackendId::CAPACITY bytes. The identity is never truncated.

pub fn as_str(&self) -> &str

Identifier text.

Trait Implementations

impl Clone for BackendId

fn clone(&self) -> BackendId

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BackendId

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

Formats the value using the given formatter.

impl Display for BackendId

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

Formats the value using the given formatter.

impl Hash for BackendId

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for BackendId

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for BackendId

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for BackendId

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Copy for BackendId

impl Eq for BackendId