#[repr(C, align(32))]pub struct U256(pub [u64; 4]);Expand description
Entier 256-bit non signé représenté sur 4 mots de 64-bit (Little-Endian).
self.0[0] contient les bits 0..64, self.0[3] contient les bits
192..256.
Aligné sur 32 octets pour maximiser l’efficacité du cache et des registres AVX/SIMD du CPU.
Tuple Fields§
§0: [u64; 4]Implementations§
Source§impl U256
impl U256
Sourcepub const fn from_limbs(limbs: [u64; 4]) -> Self
pub const fn from_limbs(limbs: [u64; 4]) -> Self
Création à partir de 4 mots u64 (Little-Endian : limbs[0] = bits
de poids faible).
Sourcepub fn wrapping_add(&self, rhs: &Self) -> Self
pub fn wrapping_add(&self, rhs: &Self) -> Self
Addition 256-bit déterministe avec propagation de la retenue (Overflow).
Le résultat est tronqué mod 2²⁵⁶ (sémantique “wrapping” standard) : tout débordement au-delà du 4ème mot est silencieusement abandonné.
Utilise overflowing_add sous le capot pour une traduction directe
en instructions ASM CPU (ADC).
Sourcepub fn wrapping_mul(&self, rhs: &Self) -> Self
pub fn wrapping_mul(&self, rhs: &Self) -> Self
Multiplication 256-bit x 256-bit -> 256-bit (tronquée mod 2²⁵⁶).
Implémentation “schoolbook” (Comba), colonne par colonne, avec propagation complète de la retenue à chaque produit partiel. Zéro allocation, zéro mémoire heap, 100% dans les registres CPU.
Toute contribution qui dépasserait le bit 255 (c’est-à-dire les
produits partiels a[i] * b[j] avec i + j >= 4, ainsi que la
retenue finale de la dernière colonne) est abandonnée, conformément
à la sémantique “wrapping” (résultat mod 2²⁵⁶).
Sourcepub fn wrapping_sub(&self, rhs: &Self) -> Self
pub fn wrapping_sub(&self, rhs: &Self) -> Self
Soustraction 256-bit déterministe avec propagation de l’emprunt (Borrow).
Le résultat est tronqué mod 2²⁵⁶ : si rhs > self, le résultat
“boucle” (comportement identique à u64::wrapping_sub).