Struct BackendNumericPolicy 

pub struct BackendNumericPolicy { /* private fields */ }

Backend-bound numeric conversion policy.

Backends should keep their label in one constant of this type instead of cloning one local wrapper per numeric helper. The free functions below remain available for backend-neutral callers and tests.

Implementations

impl BackendNumericPolicy

pub const fn new(backend: &'static str) -> Self

Create a numeric policy that annotates diagnostics with backend.

pub const fn backend(self) -> &'static str

Return the backend label used in numeric diagnostics.

pub fn usize_to_u64( self, value: usize, label: &str, ) -> Result<u64, BackendError>

Convert a host usize to a backend/API u64.

Errors

Returns BackendError::InvalidProgram when the value cannot fit in the backend/API boundary type.

pub fn u128_to_u64(self, value: u128, label: &str) -> Result<u64, BackendError>

Convert a wide counter to telemetry u64.

Errors

Returns BackendError::InvalidProgram when the counter does not fit in telemetry storage.

pub fn elapsed_nanos_u64( self, started: Instant, label: &str, ) -> Result<u64, BackendError>

Convert elapsed wall-clock time to telemetry nanoseconds.

Errors

Returns BackendError::InvalidProgram when the elapsed nanoseconds cannot fit in telemetry storage.

pub fn rounded_f64_to_u64( self, value: f64, label: &str, ) -> Result<u64, BackendError>

Round a finite floating-point nanosecond value into telemetry storage.

Errors

Returns BackendError::InvalidProgram when the rounded value is negative, non-finite, or too large for telemetry storage.

pub fn ratio_basis_points_u64( self, part: u64, whole: u64, denominator_zero_value: u32, label: &str, ) -> u32

Compute part / whole as floor basis points in a u32 telemetry domain.

pub fn ratio_basis_points_u64_wide( self, part: u64, whole: u64, denominator_zero_value: u64, label: &str, ) -> u64

Compute part / whole as floor basis points in a u64 telemetry domain.

pub fn ratio_parts_per_million_u64( self, part: u64, whole: u64, denominator_zero_value: u32, label: &str, ) -> u32

Compute part / whole as floor parts-per-million.

pub fn compose_basis_points_u32(self, left: u32, right: u32, label: &str) -> u32

Compose two basis-point multipliers into a u32 result.

pub fn scale_u64_by_basis_points_round_clamped( self, base: u64, scale_bps: u32, zero_scale_value: u64, max_scale_bps: u32, label: &str, ) -> u64

Apply rounded basis-point scaling with optional high clamp.

pub fn scale_u64_by_basis_points_floor_min( self, base: u64, scale_bps: u32, min_value: u64, label: &str, ) -> u64

Apply floor basis-point scaling with a lower bound.

pub fn finite_f64_to_u32_trunc(self, value: f64, label: &str) -> u32

Convert finite non-negative floating-point telemetry to u32 by truncation.

pub fn finite_f64_to_u32_round(self, value: f64, label: &str) -> u32

Convert finite non-negative floating-point telemetry to rounded u32.

pub fn finite_f64_ratio_basis_points_trunc( self, numerator: f64, denominator: f64, invalid_numerator_value: u32, invalid_denominator_value: u32, label: &str, ) -> u32

Convert a finite floating-point ratio into floor basis points.

pub fn finite_f64_ratio_basis_points_round( self, numerator: f64, denominator: f64, invalid_numerator_value: u32, invalid_denominator_value: u32, label: &str, ) -> u32

Convert a finite floating-point ratio into rounded basis points.

pub fn finite_f64_unit_basis_points_trunc( self, value: f64, invalid_value: u32, label: &str, ) -> u32

Convert a finite scalar where 1.0 == 10_000 bps into floor basis points.

pub fn checked_ceil_div_u64(self, value: u64, divisor: u64) -> Option<u64>

Compute ceil(value / divisor) in u64, returning None for zero divisors or arithmetic overflow.

pub fn checked_dim_product_u64(self, dims: [u32; 3]) -> Option<u64>

Multiply three u32 launch dimensions into a u64 without wraparound.

pub fn checked_dim_product_u32(self, dims: [u32; 3]) -> Option<u32>

Multiply three u32 launch dimensions into a u32 without wraparound.

pub fn align_up_u64( self, value: u64, alignment: u64, min_value: u64, label: &str, ) -> Result<u64, BackendError>

Align value upward to alignment, after applying min_value.

Errors

Returns BackendError::InvalidProgram when alignment is zero or the padded value would overflow u64.

pub fn align_up_usize( self, value: usize, alignment: usize, min_value: usize, label: &str, ) -> Result<usize, BackendError>

Align value upward to alignment, after applying min_value.

Errors

Returns BackendError::InvalidProgram when alignment is zero or the padded value would overflow usize.

Trait Implementations

impl Clone for BackendNumericPolicy

fn clone(&self) -> BackendNumericPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for BackendNumericPolicy

impl Debug for BackendNumericPolicy

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

Formats the value using the given formatter.

impl Eq for BackendNumericPolicy

impl PartialEq for BackendNumericPolicy

fn eq(&self, other: &BackendNumericPolicy) -> 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 StructuralPartialEq for BackendNumericPolicy