using System.Numerics; using System.Runtime.CompilerServices; namespace PerfectNumbers.Core; public static class ULongExtensions { public static ulong CalculateOrder(this ulong q) { if (q <= 2UL) { return 0UL; } ulong order = q - 1UL, prime, temp; uint[] smallPrimes = PrimesGenerator.SmallPrimes; ulong[] smallPrimesPow2 = PrimesGenerator.SmallPrimesPow2; int i = 0, primesLength = smallPrimes.Length; UInt128 q128 = q, cycle = MersenneDivisorCycles.GetCycle(q128); for (; i < primesLength; i++) { if (smallPrimesPow2[i] > order) { break; } prime = smallPrimes[i]; while (order % prime == 0UL) { temp = order / prime; if (temp.PowModWithCycle(q128, cycle) == UInt128.One) { order = temp; } else { break; } } } return order; } [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ulong FastDiv64(this ulong value, ulong divisor, ulong mul) { ulong q = value.MulHigh(mul); if ((UInt128)value - q.Mul64(divisor) >= divisor) { q++; } return q; } [MethodImpl(MethodImplOptions.AggressiveInlining)] public static void Mod10_8_5_3(this ulong value, out ulong mod10, out ulong mod8, out ulong mod5, out ulong mod3) { ulong temp = value; uint byteSum = 0U; do { byteSum += (byte)temp; temp >>= 8; } while (temp != 0UL); mod8 = value & 7UL; uint mod5Value = PerfectNumbersMath.FastRemainder5(byteSum); uint mod3Value = PerfectNumbersMath.FastRemainder3(byteSum); ulong parity = mod8 & 1UL; mod10 = parity == 0UL ? mod5Value switch { 0U => 0UL, 1U => 6UL, 2U => 2UL, 3U => 8UL, _ => 4UL, } : mod5Value switch { 0U => 5UL, 1U => 1UL, 2U => 7UL, 3U => 3UL, _ => 9UL, }; mod5 = mod5Value; mod3 = mod3Value; } [MethodImpl(MethodImplOptions.AggressiveInlining)] public static void Mod10_8_5_3Steps(this ulong value, out ulong step10, out ulong step8, out ulong step5, out ulong step3) { value.Mod10_8_5_3(out ulong mod10, out ulong mod8, out ulong mod5, out ulong mod3); step10 = (mod10 << 1).Mod10(); step8 = ((mod8 << 1) & 7UL); step5 = (mod5 << 1).Mod5(); step3 = (mod3 << 1).Mod3(); } [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsPrimeCandidate(this ulong n) { int i = 0; ulong p; uint[] smallPrimes = PrimesGenerator.SmallPrimes; ulong[] smallPrimesPow2 = PrimesGenerator.SmallPrimesPow2; int len = smallPrimes.Length; for (; i < len; i++) { if (smallPrimesPow2[i] > n) { break; } p = smallPrimes[i]; if ((n % p) == 0UL) { return n == p; } } return true; } [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ulong Mod10(this ulong value) { ulong parity = value & 1UL; ulong mod5 = value.Mod5(); if (parity == 0UL) { return mod5 switch { 0UL => 0UL, 1UL => 6UL, 2UL => 2UL, 3UL => 8UL, _ => 4UL, }; } return mod5 switch { 0UL => 5UL, 1UL => 1UL, 2UL => 7UL, 3UL => 3UL, _ => 9UL, }; } [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ulong Mod8(this ulong value) => value & 7UL; [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ulong Mod3(this ulong value) { uint sum = (uint)(value & 0xFFFFUL); sum += (uint)((value >> 16) & 0xFFFFUL); sum += (uint)((value >> 32) & 0xFFFFUL); sum += (uint)((value >> 48) & 0xFFFFUL); return PerfectNumbersMath.FastRemainder3(sum); } [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ulong Mod5(this ulong value) { uint sum = (uint)(value & 0xFFFFUL); sum += (uint)((value >> 16) & 0xFFFFUL); sum += (uint)((value >> 32) & 0xFFFFUL); sum += (uint)((value >> 48) & 0xFFFFUL); return PerfectNumbersMath.FastRemainder5(sum); } [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ulong Mod7(this ulong value) { uint low = (uint)value; uint high = (uint)(value >> 32); ulong remainder = low.Mod7() + (ulong)high.Mod7() * 4UL; while (remainder >= 7UL) { remainder -= 7UL; } return remainder; } [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ulong Mod11(this ulong value) { uint low = (uint)value; uint high = (uint)(value >> 32); ulong remainder = low.Mod11() + (ulong)high.Mod11() * 4UL; while (remainder >= 11UL) { remainder -= 11UL; } return remainder; } [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ulong Mod128(this ulong value) => value & 127UL; [MethodImpl(MethodImplOptions.AggressiveInlining)] public static UInt128 Mul64(this ulong a, ulong b) => ((UInt128)a.MulHigh(b) << 64) | (UInt128)(a * b); [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ulong MulHigh(this ulong x, ulong y) { ulong xLow = (uint)x; ulong xHigh = x >> 32; ulong yLow = (uint)y; ulong yHigh = y >> 32; ulong w1 = xLow * yHigh; ulong w2 = xHigh * yLow; ulong carry = (((xLow * yLow) >> 32) + (uint)w1 + (uint)w2) >> 32; return (xHigh * yHigh) + (w1 >> 32) + (w2 >> 32) + carry; } [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ulong ModPow64(this ulong value, ulong exponent, ulong modulus) { ulong result = 1UL; ulong baseValue = value % modulus; while (exponent != 0UL) { if ((exponent & 1UL) != 0UL) { result = MulMod64(result, baseValue, modulus); } baseValue = MulMod64(baseValue, baseValue, modulus); exponent >>= 1; } return result; } [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ulong MulMod64(this ulong a, ulong b, ulong modulus) => (ulong)(UInt128)(((a % modulus) * (b % modulus)) % modulus); [MethodImpl(MethodImplOptions.AggressiveInlining)] public static UInt128 PowMod(this ulong exponent, UInt128 modulus) { // Return 1 because 2^0 = 1 if (exponent == 0UL) return UInt128.One; // Any number mod 1 is 0 if (modulus == UInt128.One) return UInt128.Zero; UInt128 result; // For small exponents, do classic method if (exponent < 64 || modulus < 4) { result = UInt128.One; for (ulong i = 0; i < exponent; i++) { result <<= 1; if (result >= modulus) result -= modulus; } return result; } // Special case: if modulus is a power of two, use bitmasking for efficiency and correctness if ((modulus & (modulus - 1)) == 0) { result = UInt128.One << (int)(exponent & 127); return result & (modulus - 1); } // For general modulus, use classic left-to-right binary method for 2^exponent mod modulus UInt128 resultBin = UInt128.One; for (ulong i = 0; i < exponent; i++) { resultBin <<= 1; if (resultBin >= modulus) resultBin -= modulus; } return resultBin; } /// /// Computes 2^exponent mod modulus using a known cycle length. /// public static UInt128 PowModWithCycle(this ulong exponent, UInt128 modulus, ulong cycleLength) { // Return 1 because 2^0 = 1 if (exponent == 0UL) return UInt128.One; // Any number mod 1 is 0 if (modulus == UInt128.One) return UInt128.Zero; // For small exponents, do classic method UInt128 result; if (exponent < 64 || modulus < 4) { result = UInt128.One; for (ulong i = 0; i < exponent; i++) { result <<= 1; if (result >= modulus) result -= modulus; } return result; } // Special case: if modulus is a power of two, use bitmasking for efficiency and correctness if ((modulus & (modulus - 1)) == 0) { result = UInt128.One << (int)(exponent & 127); return result & (modulus - 1); } // For general modulus, use classic left-to-right binary method for 2^exponent mod modulus result = UInt128.One; UInt128 rotations = exponent % cycleLength; for (ulong i = 0; i < rotations; i++) { result <<= 1; if (result >= modulus) result -= modulus; } return result; } /// /// Computes 2^exponent mod modulus using a known cycle length. /// public static UInt128 PowModWithCycle(this ulong exponent, UInt128 modulus, UInt128 cycleLength) { // Return 1 because 2^0 = 1 if (exponent == UInt128.Zero) return UInt128.One; // Any number mod 1 is 0 if (modulus == UInt128.One) return UInt128.Zero; // For small exponents, do classic method UInt128 result; if (exponent < UInt128Numbers.SixtyFour || modulus < UInt128Numbers.Four) { result = UInt128.One; for (ulong i = 0; i < exponent; i++) { result <<= 1; if (result >= modulus) result -= modulus; } return result; } // Special case: if modulus is a power of two, use bitmasking for efficiency and correctness if ((modulus & (modulus - UInt128.One)) == UInt128.Zero) { result = UInt128.One << (int)(exponent & UInt128Numbers.OneHundredTwentySeven); return result & (modulus - 1); } // For general modulus, use classic left-to-right binary method for 2^exponent mod modulus result = UInt128.One; UInt128 rotations = exponent % cycleLength; for (UInt128 i = 0; i < rotations; i++) { result <<= 1; if (result >= modulus) result -= modulus; } return result; } /// /// Computes 2^exponent mod modulus using a known cycle length. /// public static UInt128 PowModWithCycle(this UInt128 exponent, UInt128 modulus, UInt128 cycleLength) { // Return 1 because 2^0 = 1 if (exponent == UInt128.Zero) return UInt128.One; // Any number mod 1 is 0 if (modulus == UInt128.One) return UInt128.Zero; UInt128 result; // For small exponents, do classic method if (exponent < UInt128Numbers.SixtyFour || modulus < UInt128Numbers.Four) { result = UInt128.One; for (ulong i = 0; i < exponent; i++) { result <<= 1; if (result >= modulus) result -= modulus; } return result; } // Special case: if modulus is a power of two, use bitmasking for efficiency and correctness if ((modulus & (modulus - UInt128.One)) == UInt128.Zero) { result = UInt128.One << (int)(exponent & UInt128Numbers.OneHundredTwentySeven); return result & (modulus - 1); } // For general modulus, use classic left-to-right binary method for 2^exponent mod modulus result = UInt128.One; UInt128 rotations = exponent % cycleLength; for (UInt128 i = 0; i < rotations; i++) { result <<= 1; if (result >= modulus) result -= modulus; } return result; } /// /// Computes 2^exponent mod modulus using iterative CRT composition from mod 10 up to modulus. /// Only for modulus >= 10 and reasonable size. /// public static UInt128 PowModCrt(this ulong exponent, UInt128 modulus, MersenneDivisorCycles cycles) { if (modulus < 10) return PowMod(exponent, modulus); // fallback to classic // Use cycle length 4 for mod 10 UInt128 result = PowModWithCycle(exponent, 10, 4); UInt128 currentModulus = 10; for (UInt128 m = 11; m <= modulus; m++) { UInt128 cycle = MersenneDivisorCycles.GetCycle(m); UInt128 remM = cycle > 0 ? PowModWithCycle(exponent, m, cycle) : PowMod(exponent, m); // Solve x ≡ result mod currentModulus // x ≡ remM mod m // Find x mod (currentModulus * m) // Since currentModulus and m are coprime, use CRT: // x = result + currentModulus * t, where t ≡ (remM - result) * inv(currentModulus, m) mod m UInt128 inv = ModInverse(currentModulus, m); UInt128 t = ((remM + m - (result % m)) * inv) % m; result += currentModulus * t; currentModulus *= m; if (currentModulus >= modulus) break; } return result % modulus; } // Helper: modular inverse (extended Euclidean algorithm) private static UInt128 ModInverse(UInt128 a, UInt128 m) { UInt128 m0 = m, t, q; UInt128 x0 = 0, x1 = 1; if (m == 1) return 0; while (a > 1) { q = a / m; t = m; m = a % m; a = t; t = x0; x0 = x1 - q * x0; x1 = t; } if (x1 < 0) x1 += m0; return x1; } [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool SharesFactorWithExponentMinusOne(this ulong exponent) { ulong value = exponent - 1UL; value >>= BitOperations.TrailingZeroCount(value); uint[] smallPrimes = PrimesGenerator.SmallPrimes; ulong[] smallPrimesPow2 = PrimesGenerator.SmallPrimesPow2; int i = 1, smallPrimesLength = smallPrimes.Length; ulong prime; for (; i < smallPrimesLength && smallPrimesPow2[i] <= value; i++) { prime = smallPrimes[i]; if (value % prime != 0UL) { continue; } if (exponent % prime.CalculateOrder() == 0UL) { return true; } do { value /= prime; } while (value % prime == 0UL); } if (value > 1UL && exponent % value.CalculateOrder() == 0UL) { return true; } return false; } }