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 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(ulong value) { ulong quotient = (ulong)(((UInt128)value * 0xCCCCCCCCCCCCCCCDUL) >> 67); return value - quotient * 10UL; } [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; } }