using System.Numerics; using System.Runtime.CompilerServices; using PerfectNumbers.Core.Gpu; 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 quotient = (ulong)(((UInt128)value * mul) >> 64); UInt128 remainder = (UInt128)value - ((UInt128)quotient * divisor); if (remainder >= divisor) { quotient++; } return quotient; } public const ulong WordBitMask = 0xFFFFUL; [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsPrimeCandidate(this ulong n) { int i = 0; uint[] smallPrimes = PrimesGenerator.SmallPrimes; ulong[] smallPrimesPow2 = PrimesGenerator.SmallPrimesPow2; int len = smallPrimes.Length; ulong p; 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) => (value & 1UL) == 0UL ? (value % 5UL) switch { 0UL => 0UL, 1UL => 6UL, 2UL => 2UL, 3UL => 8UL, _ => 4UL, } : (value % 5UL) switch { 0UL => 5UL, 1UL => 1UL, 2UL => 7UL, 3UL => 3UL, _ => 9UL, }; [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ulong Mod128(this ulong value) => value & 127UL; [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) { mod8 = value & 7UL; byte current; uint byteSum = 0U; do { current = (byte)value; byteSum += current; value >>= 8; } while (value != 0UL); mod3 = byteSum % 3U; mod5 = byteSum % 5U; mod10 = (mod8 & 1UL) == 0UL ? mod5 switch { 0UL => 0UL, 1UL => 6UL, 2UL => 2UL, 3UL => 8UL, _ => 4UL, } : mod5 switch { 0UL => 5UL, 1UL => 1UL, 2UL => 7UL, 3UL => 3UL, _ => 9UL, }; } [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 step10, out step8, out step5, out step3); step10 = (step10 << 1).Mod10(); step8 = (step8 << 1) & 7UL; step5 = (step5 << 1) % 5UL; step3 = (step3 << 1) % 3UL; } [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 result = (xHigh * yHigh) + (w1 >> 32) + (w2 >> 32); result += (((xLow * yLow) >> 32) + (uint)w1 + (uint)w2) >> 32; return result; } [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ulong ModPow64(this ulong value, ulong exponent, ulong modulus) { ulong result = 1UL; value %= modulus; while (exponent != 0UL) { if ((exponent & 1UL) != 0UL) { result = MulMod64(result, value, modulus); } value = MulMod64(value, value, 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 ulong MontgomeryMultiply(this ulong a, ulong b, ulong modulus, ulong nPrime) { ulong tLow = unchecked(a * b); ulong m = unchecked(tLow * nPrime); ulong mTimesModulusLow = unchecked(m * modulus); ulong result = unchecked(a.MulHigh(b) + m.MulHigh(modulus) + (unchecked(tLow + mTimesModulusLow) < tLow ? 1UL : 0UL)); if (result >= modulus) { result -= modulus; } return result; } [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ulong Pow2MontgomeryMod(this ulong exponent, in MersenneNumberDivisorByDivisorGpuTester.MontgomeryDivisorData divisor) { ulong modulus = divisor.Modulus; if (modulus <= 1UL || (modulus & 1UL) == 0UL) { return 0UL; } ulong result = divisor.MontgomeryOne; ulong baseVal = divisor.MontgomeryTwo; ulong nPrime = divisor.NPrime; ulong remainingExponent = exponent; while (remainingExponent > 0UL) { if ((remainingExponent & 1UL) != 0UL) { result = result.MontgomeryMultiply(baseVal, modulus, nPrime); } remainingExponent >>= 1; if (remainingExponent == 0UL) { break; } baseVal = baseVal.MontgomeryMultiply(baseVal, modulus, nPrime); } return result.MontgomeryMultiply(1UL, modulus, nPrime); } [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ulong Pow2MontgomeryModWithCycle(this ulong exponent, ulong cycleLength, in MersenneNumberDivisorByDivisorGpuTester.MontgomeryDivisorData divisor) { if (cycleLength == 0UL) { return exponent.Pow2MontgomeryMod(divisor); } ulong rotationCount = exponent % cycleLength; if (rotationCount == 0UL) { return 1UL; } return rotationCount.Pow2MontgomeryMod(divisor); } [MethodImpl(MethodImplOptions.AggressiveInlining)] public static UInt128 PowMod(this ulong exponent, UInt128 modulus) { UInt128 result = UInt128.One; ulong exponentLoopIndex = 0UL; // Return 1 because 2^0 = 1 if (exponent == 0UL) return result; // Any number mod 1 is 0 if (modulus == UInt128.One) return UInt128.Zero; // For small exponents, do classic method if (exponent < 64 || modulus < 4) { for (; exponentLoopIndex < exponent; exponentLoopIndex++) { 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); } // Reusing exponentLoopIndex to iterate again over the exponent range for the general-case accumulation. exponentLoopIndex = 0UL; // Reusing result after resetting it for the general modulus accumulation phase. result = UInt128.One; for (; exponentLoopIndex < exponent; exponentLoopIndex++) { 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, ulong cycleLength) { UInt128 result = UInt128.One; ulong exponentLoopIndex = 0UL; // Return 1 because 2^0 = 1 if (exponent == 0UL) return result; // Any number mod 1 is 0 if (modulus == UInt128.One) return UInt128.Zero; // For small exponents, do classic method if (exponent < 64 || modulus < 4) { for (; exponentLoopIndex < exponent; exponentLoopIndex++) { 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); } // Reusing exponentLoopIndex to iterate over the rotation count for the cycle-aware path. exponentLoopIndex = 0UL; // Reusing result after resetting it for the rotation-accumulation pass. result = UInt128.One; ulong rotationCount = exponent % cycleLength; for (; exponentLoopIndex < rotationCount; exponentLoopIndex++) { 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) { UInt128 result = UInt128.One; ulong exponentLoopIndex = 0UL; // Return 1 because 2^0 = 1 if (exponent == UInt128.Zero) return result; // Any number mod 1 is 0 if (modulus == UInt128.One) return UInt128.Zero; // For small exponents, do classic method if (exponent < UInt128Numbers.SixtyFour || modulus < UInt128Numbers.Four) { for (; exponentLoopIndex < exponent; exponentLoopIndex++) { 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); } // Reusing result after resetting it for the rotation-driven accumulation phase. result = UInt128.One; UInt128 rotationCount = exponent % cycleLength; UInt128 rotationIndex = UInt128.Zero; while (rotationIndex < rotationCount) { result <<= 1; if (result >= modulus) result -= modulus; rotationIndex += UInt128.One; } return result; } /// /// Computes 2^exponent mod modulus using a known cycle length. /// public static UInt128 PowModWithCycle(this UInt128 exponent, UInt128 modulus, UInt128 cycleLength) { UInt128 one = UInt128.One, result = one, zero = UInt128.Zero; ulong exponentLoopIndex = 0UL; // Return 1 because 2^0 = 1 if (exponent == zero) return result; // Any number mod 1 is 0 if (modulus == one) return zero; // For small exponents, do classic method if (exponent < UInt128Numbers.SixtyFour || modulus < UInt128Numbers.Four) { for (; exponentLoopIndex < exponent; exponentLoopIndex++) { 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 - one)) == zero) { result = one << (int)(exponent & UInt128Numbers.OneHundredTwentySeven); return result & (modulus - 1); } // Reusing result after resetting it for the rotation-driven accumulation phase. result = one; UInt128 rotationCount = exponent % cycleLength; // We're reusing "zero" as rotation index for just a little better performance while (zero < rotationCount) { result <<= 1; if (result >= modulus) result -= modulus; zero += one; } 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 currentModulus = 10, cycle, modulusCandidate = 11, remainderForCandidate, result = PowModWithCycle(exponent, 10, 4), zero = UInt128.Zero; for (; modulusCandidate <= modulus; modulusCandidate++) { cycle = MersenneDivisorCycles.GetCycle(modulusCandidate); remainderForCandidate = cycle > zero ? PowModWithCycle(exponent, modulusCandidate, cycle) : PowMod(exponent, modulusCandidate); // 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 result += currentModulus * ((remainderForCandidate + modulusCandidate - (result % modulusCandidate)) * ModInverse(currentModulus, modulusCandidate) % modulusCandidate); currentModulus *= modulusCandidate; if (currentModulus >= modulus) break; } return result % modulus; } // Helper: modular inverse (extended Euclidean algorithm) private static UInt128 ModInverse(UInt128 a, UInt128 m) { UInt128 m0 = m, originalA, originalM, temp, x0 = 0, x1 = 1; if (m == 1) { return 0; } while (a > 1) { originalA = a; originalM = m; m = originalA % originalM; a = originalM; temp = x0; x0 = x1 - (originalA / originalM) * x0; x1 = temp; } if (x1 < 0) { x1 += m0; } return x1; } [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool SharesFactorWithExponentMinusOne(this ulong exponent) { ulong prime, value = exponent - 1UL; value >>= BitOperations.TrailingZeroCount(value); uint[] smallPrimes = PrimesGenerator.SmallPrimes; ulong[] smallPrimesPow2 = PrimesGenerator.SmallPrimesPow2; int i = 1, smallPrimesLength = smallPrimes.Length; 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; } }