finitefields

Crates.iofinitefields
lib.rsfinitefields
version0.1.1
sourcesrc
created_at2021-03-24 16:15:13.285953
updated_at2021-03-26 15:22:10.902388
descriptionPerform algebraic operations between integers over a finite field
homepage
repositoryhttps://github.com/apelloni/finitefields
max_upload_size
id372973
size91,096
Snaporaz (apelloni)

documentation

README

finitefields

crates.io documentation Build Status Byy Me A Coffee

Allows to perform simple algebraic operations over a finite field

Arguments

  • value - number be represented as value % modulo
  • modulo - An integer corresponding to the size of the modular space. For this to be a finite field it must be a prime number!

Operations

  • addition
  • subtraction
  • multiplication
  • division
  • inversion

Examples

// Simple operations within a finite field

use finitefields::{FF,Finitefield,primes};

fn main(){
    // Pick a prime
    let modulo = primes::PRIMES31[0];
    // Define numbers to be cast into our field
    let num1: FF = 23742687;
    let num2: FF = 87129774;

    let fnum1 = Finitefield::new(num1, modulo).unwrap();
    let fnum2 = Finitefield::new(num2, modulo).unwrap();

    // Compute product
    let product = fnum1 * fnum2;
    assert_eq!(product.value, 174523906);

    // Compute the inverse of the product
    let product_inv = product.inverse().unwrap();
    assert_eq!(product_inv.value, 486606559);

    // Multiply by the product
    assert_eq!((product * product_inv).value, 1);
}
Commit count: 15

cargo fmt