Crate guff[−][src]

Expand description

Grand Unified Finite Field library*

Implements GF(2^x) for various “natural” sizes such as 2⁸, 2¹⁶ and 2³².

Basic Use: doing maths in a particular field

As a user, the steps to take to use this library are:

decide what “class” of field you want to use (GF(2⁸), GF(2¹⁶), etc.);
decide if you want to use one of the optimised adaptations or are happy with the default, generic code;
create a new field object (we can call f) of that class with your chosen field polynomial (aka “irreducible polynomial”) by calling the appropriate constructor;
use that object to do maths in that field: eg, result = f.mul(a,b)

use guff::{GaloisField, F4};
 
fn main() {
    // create a GF(2<sup>4</sup>) field from a struct
    // * `19` is the field's irreducible polynomial
    // * `3` is the same value with bit 0x10 removed
    let f = guff::F4 { full : 19, compact : 3 };
     
    assert_eq!(f.pow(5,3), f.mul(5,f.mul(5,5)) );
}