Best Use & Engineering Application Guide

Engineering Category: Exact Integer Number Theory & Transcendentals

Best Use in Production: Hardware-verified modular arithmetic, integer roots, and combinatorial invariants for exact rational math engines and cryptographic primitives.

When to Select This Capsule: Holds the #1 Equivalence Crown across 2 functionally identical implementations (fastest verified hardware _rdtsc). Sub-10-cycle hardware kernel (1074443/200000 cyc/op); safe for ultra-hot per-sample or per-packet inner loops.

Snap-Circuit Wiring Role: Specialized Multi-Pin Stage `(u64)->u8` — wire matching input pins via `snap_dag` or `snap_pipeline`.

Hardware _rdtsc: 1074443/200000 cycles/op
Latency: 116609/80000 ns/op
Throughput: 80000000/116609 ops/us
Compiled ELF64 .text: 78 B (25 x86_64 insns)
C64 64KB RAM Budget: 39/8192 (312 B source)
Ternary Vote: + (score 1) | Salience: 510481/5928
Pure-Rust Capsule Source Code (312 B)
pub const fn ilog2_1p_q4(v: u64) -> u8 { let x = v.saturating_add(1); let lz = x.leading_zeros(); let exp = 63u32.saturating_sub(lz); let mantissa = if exp >= 4 { ((x >> (exp - 4)) & 0x0F) as u32 } else { ((x << (4 - exp)) & 0x0F) as u32 }; let q4 = (exp << 4) | mantissa; if q4 > 255 { 255 } else { q4 as u8 } }
rustc -C opt-level=3 x86_64 Disassembly (78 B .text / 25 insns)
ilog2_1p_q4:
    inc    rdi
    mov    rax, -1
    cmovne    rax, rdi
    bsr    rdx, rax
    cmp    edx, 3
    jbe    .LBB7_1
    mov    rsi, rdx
    xor    rsi, 63
    mov    cl, 59
    sub    cl, sil
    shr    rax, cl
    mov    ecx, 15
    jmp    .LBB7_3
.LBB7_1:
    mov    cl, 4
    sub    cl, dl
    shl    rax, cl
    mov    ecx, 14
.LBB7_3:
    and    eax, ecx
    mov    ecx, edx
    shl    ecx, 4
    or    ecx, eax
    cmp    edx, 16
    mov    eax, 255
    cmovb    eax, ecx
    ret

Head-to-Head Functional Equivalence Class Peers (2 Implementation(s) Matching 64 Test Vectors)

Global RankCapsule & DomainHardware _rdtscLatencyThroughputELF .textTernary VoteAuthor Aye
#26ilog2_1p_q4 (THIS CAPSULE)
domain: ayecast-x86_64 | id: b8e9f4987afcc2240966221c39d7a56f
1074443/200000 cyc/op116609/80000 ns/op80000000/116609 ops/us78 B .text (25 insns)+ (1)aye::Hue+Gemini(0+1)::x86_64 @ 432Hz
#27ilog2_1p_q4
domain: ayecast-x86_64 | id: 539985bf48ce0e5110f9f306d45aef8c
268503/50000 cyc/op23311/16000 ns/op16000000/23311 ops/us78 B .text (25 insns)+ (1)aye::Hue+Gemini(0+1)::x86_64 @ 432Hz