pub struct MultiplesAtLeast { /* private fields */ }Expand description
Count of multiples of multiple needed to cover value.
Signature: multiples_at_least(value: u64, multiple: u64) -> (u64)
Companion to CeilToMultiple that returns the count
instead of the product — i.e. ceil(value / multiple). The
invariant multiples_at_least(v, m) * m == ceil_to_multiple(v, m)
holds whenever multiple > 0 and the multiplication doesn’t
overflow.
Use cases:
- calibration:
multiples_at_least(min_cycles, base)gives the pass count so the workload can both apply the multiplier and report “ran N passes” for diagnostics - bucket arithmetic: count of fixed-size buckets needed to hold N items
multiple == 0 returns 0 — there is no count that covers
a positive value with zero-sized multiples; rather than
trap, the function quietly yields the only honest answer.
JIT level: P3 (single udiv_ceil).
Count of multiples needed to cover value. SRD-80 PR B.13.
multiple == 0 returns 0 (no count covers positive value
with zero-sized multiples). JIT P3.
Implementations§
Trait Implementations§
Source§impl Default for MultiplesAtLeast
impl Default for MultiplesAtLeast
Source§impl PolydatNode for MultiplesAtLeast
impl PolydatNode for MultiplesAtLeast
Source§fn compiled_u64(&self) -> Option<CompiledU64Op>
fn compiled_u64(&self) -> Option<CompiledU64Op>
Return a compiled u64-only evaluation closure, if this node
operates entirely in u64 space. Read more
Source§fn jit_constants(&self) -> Vec<u64>
fn jit_constants(&self) -> Vec<u64>
Return assembly-time constants for JIT compilation. Read more
Source§fn scratch_layout(&self) -> Vec<ScratchElem>
fn scratch_layout(&self) -> Vec<ScratchElem>
The scratch entries a state owns for this node’s evaluation
(axiom S3), one per entry in the order the node expects them
in
Self::eval_in. Empty for a node that evaluates over
Values alone, which is every node but a native cone.Source§fn eval_in(
&self,
scratch: &mut [ScratchBuf],
inputs: &[Value],
outputs: &mut [Value],
)
fn eval_in( &self, scratch: &mut [ScratchBuf], inputs: &[Value], outputs: &mut [Value], )
Self::eval with the node’s scratch, which the evaluating
state owns and hands in: storage belongs to the state, never to
the node, which is shared by every state of the program.Source§fn commutativity(&self) -> Commutativity
fn commutativity(&self) -> Commutativity
Declare which inputs are interchangeable for this node. Read more
Source§fn accepts_none_inputs(&self) -> bool
fn accepts_none_inputs(&self) -> bool
True iff this node should receive
Value::None inputs
directly rather than have the kernel propagate None through
it. Default: false — most nodes follow SRD-74 Rule 1
(None in → None out, no eval invocation). Read moreSource§fn compiled_slot(&self, _wire_types: &[PortType]) -> Option<CompiledSlotKit>
fn compiled_slot(&self, _wire_types: &[PortType]) -> Option<CompiledSlotKit>
Return a slot-compiled closure for nodes with typed-slice
ports (§8.4 layer 3): slice inputs read
(ptr, len) slot
pairs; vector outputs write into kernel-owned scratch.
Checked by the compiled-kernel builders AFTER
Self::compiled_u64 — pure-scalar nodes never need it.
Default None: the node stays on typed eval.Source§fn purity(&self) -> Purity
fn purity(&self) -> Purity
Declare this node’s purity status per the
runtime_model.md’s D2 axiom. Default:
Purity::Pure. Override to declare an observable
side channel (Purity::SideChannel) or
eval-call-spanning state (Purity::Nondeterministic). Read moreSource§fn simd_variant(&self) -> Option<SimdVariant>
fn simd_variant(&self) -> Option<SimdVariant>
Explicit SIMD-native implementation of this scalar node, if one has
been registered with a semantic contract. Read more
Source§fn fusion_subgraph(&self) -> Option<FusionSubgraph<'_>>
fn fusion_subgraph(&self) -> Option<FusionSubgraph<'_>>
A synthetic fusion node’s view of the subgraph it stands in
for (SRD-105 cone extraction). Program-identity hashing
(
PolydatProgram::canonical_hash) walks THROUGH fusion
nodes into this subgraph, so identity is invariant to the
engine mix: jit=off and jit=auto compiles of the same
source hash identically, and resume-skip matching survives
mode changes. Default None: ordinary nodes hash as
themselves.Auto Trait Implementations§
impl Freeze for MultiplesAtLeast
impl RefUnwindSafe for MultiplesAtLeast
impl Send for MultiplesAtLeast
impl Sync for MultiplesAtLeast
impl Unpin for MultiplesAtLeast
impl UnsafeUnpin for MultiplesAtLeast
impl UnwindSafe for MultiplesAtLeast
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more