// 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));
}
}