const-primes 0.10.5

Work with prime numbers in const contexts. Prime generation, primality testing, prime counting, and more.
Documentation
// Copyright 2025 Johanna Sörngård
// SPDX-License-Identifier: MIT OR Apache-2.0

//! This module contains an implementation of a deterministic Miller-Rabin primality test

#[cfg(not(feature = "fast_test"))]
use crate::integer_math::{mod_mul, mod_pow};

/// Returns whether `n` is prime.
///
/// Does trial division with a small wheel up to `log2(n)` and then uses a
/// deterministic Miller-Rabin primality test.
///
/// If the `fast_test` feature is enabled this function calls the [`machine_prime::is_prime`] function with the `lucas` feature instead.
///
/// # Example
///
/// Basic usage:
///
/// ```
/// # use const_primes::is_prime;
/// const CHECK: bool = is_prime(18_446_744_073_709_551_557);
/// assert!(CHECK);
/// ```
#[must_use]
pub const fn is_prime(n: u64) -> bool {
    #[cfg(feature = "fast_test")]
    {
        machine_prime::is_prime(n)
    }

    #[cfg(not(feature = "fast_test"))]
    {
        // Since we know the maximum size of the numbers we test against
        // we can use the fact that there are known perfect bases
        // in order to make the test both fast and deterministic.
        // This list of witnesses was taken from
        // <https://en.wikipedia.org/wiki/Miller%E2%80%93Rabin_primality_test#Testing_against_small_sets_of_bases>.
        const NUM_BASES: usize = 11;
        const WITNESSES: [(u64, &[u64]); NUM_BASES] = [
            (2_046, &[2]),
            (1_373_652, &[2, 3]),
            (9_080_190, &[31, 73]),
            (25_326_000, &[2, 3, 5]),
            (4_759_123_140, &[2, 7, 61]),
            (1_112_004_669_632, &[2, 13, 23, 1_662_803]),
            (2_152_302_898_746, &[2, 3, 5, 7, 11]),
            (3_474_749_660_382, &[2, 3, 5, 7, 11, 13]),
            (341_550_071_728_320, &[2, 3, 5, 7, 11, 13, 17]),
            (3_825_123_056_546_413_050, &[2, 3, 5, 7, 11, 13, 17, 19, 23]),
            (u64::MAX, &[2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37]),
        ];

        if n == 2 || n == 3 {
            return true;
        } else if n <= 1 || n % 2 == 0 || n % 3 == 0 {
            return false;
        }

        // Use a small wheel to check up to log2(n).
        // This keeps the complexity at O(log(n)).
        let mut candidate_factor = 5;
        let trial_limit = n.ilog2() as u64;
        while candidate_factor <= trial_limit {
            if n % candidate_factor == 0 || n % (candidate_factor + 2) == 0 {
                return false;
            }
            candidate_factor += 6;
        }

        // Find r such that n = 2^d * r + 1 for some r >= 1
        let mut d = n - 1;
        while d % 2 == 0 {
            d >>= 1;
        }

        let mut i = 0;
        while i < NUM_BASES && WITNESSES[i].0 < n {
            i += 1;
        }
        let witnesses = WITNESSES[i].1;

        let mut i = 0;
        while i < witnesses.len() && witnesses[i] < n {
            if !miller_test(d, n, witnesses[i]) {
                return false;
            }
            i += 1;
        }

        true
    }
}

#[cfg(not(feature = "fast_test"))]
/// Performs a Miller-Rabin test with the witness k.
const fn miller_test(mut d: u64, n: u64, k: u64) -> bool {
    let mut x = mod_pow(k, d, n);
    if x == 1 || x == n - 1 {
        return true;
    }

    while d != n - 1 {
        x = mod_mul(x, x, n);
        d *= 2;

        if x == 1 {
            return false;
        } else if x == n - 1 {
            return true;
        }
    }

    false
}

#[cfg(test)]
mod test {
    use super::is_prime;

    #[test]
    fn check_is_prime() {
        // region: test data
        #[rustfmt::skip]
        const TEST_CASES: [bool; 100] = [false, false, true, true, false, true, false, true, false, false, false, true, false, true, false, false, false, true, false, true, false, false, false, true, false, false, false, false, false, true, false, true, false, false, false, false, false, true, false, false, false, true, false, true, false, false, false, true, false, false, false, false, false, true, false, false, false, false, false, true, false, true, false, false, false, false, false, true, false, false, false, true, false, true, false, false, false, false, false, true, false, false, false, true, false, false, false, false, false, true, false, false, false, false, false, false, false, true, false, false];
        // endregion: test data
        for (x, ans) in TEST_CASES.into_iter().enumerate() {
            assert_eq!(is_prime(x as u64), ans);
        }
        assert!(is_prime(65_521));
        assert!(is_prime(4_294_967_291));
        assert!(is_prime(18_446_744_073_709_551_557));
        assert!(is_prime(3_474_749_660_401));
        assert!(is_prime(2_039));
        assert!(is_prime(1_373_639));
        assert!(is_prime(9_080_189));
        assert!(is_prime(25_325_981));
        assert!(is_prime(4_759_123_129));
        assert!(is_prime(1_112_004_669_631));
        assert!(is_prime(2_152_302_898_729));
        assert!(is_prime(3_474_749_660_329));
        assert!(is_prime(341_550_071_728_289));
        assert!(is_prime(3_825_123_056_546_412_979));
    }
}