Struct MPI

pub struct MPI { /* private fields */ }

A big integer type

Implementations

impl MPI

pub fn new() -> Result<MPI>

Crate a new (zero-valued) MPI

pub fn new_from_bytes(val: &[u8]) -> Result<MPI>

Crate a new MPI setting value from an array of bytes (big-endian)

pub fn new_from_i32(val: i32) -> Result<MPI>

Crate a new MPI setting value from a i32

pub fn new_from_u32(val: u32) -> Result<MPI>

Crate a new MPI setting value from a u32

pub fn duplicate(&self) -> Result<MPI>

Crate a new MPI duplicating the value of self

pub fn set_i32(&mut self, val: i32) -> Result<()>

Set self to value specified with an i32

pub fn set_str(&mut self, val: &str) -> Result<()>

Set self to value specified with a string

pub fn set_bytes(&mut self, val: &[u8]) -> Result<()>

Set self to value specified with an array of bytes (big-endian)

pub fn clear(&mut self) -> Result<()>

Set self to zero

pub fn set_bit(&mut self, bit: usize) -> Result<()>

Set a specific bit of self

pub fn clear_bit(&mut self, bit: usize) -> Result<()>

Clear a specific bit of self

pub fn get_bit(&self, bit: usize) -> Result<bool>

Return the value of a bit in self

pub fn randomize( &mut self, rng: &mut RandomNumberGenerator, bits: usize, ) -> Result<()>

Randomize self to an integer of specified bit size

pub fn random_range( &mut self, rng: &mut RandomNumberGenerator, lower: &MPI, upper: &MPI, ) -> Result<()>

Randomize self to an integer within specified range

pub fn to_string(&self) -> Result<String>

Return value of self as decimal string

pub fn to_hex(&self) -> Result<String>

Return value of self as hex string

pub fn to_bin(&self) -> Result<Vec<u8>>

Return value of self as a byte array (big endian)

pub fn bit_count(&self) -> Result<usize>

Return number of significant bits

pub fn byte_count(&self) -> Result<usize>

Return number of significant bytes

pub fn to_u32(&self) -> Result<u32>

Return self as a u32, if it fits

pub fn is_positive(&self) -> Result<bool>

Return true if self is an integer >= 0

pub fn is_negative(&self) -> Result<bool>

Return true if self is an integer < 0

pub fn is_zero(&self) -> Result<bool>

Return true if self is an integer == 0

pub fn is_odd(&self) -> Result<bool>

Return true if self is odd

pub fn is_even(&self) -> Result<bool>

Return true if self is even

pub fn equals(&self, other: &MPI) -> Result<bool>

Return true if self equals other

pub fn compare(&self, other: &MPI) -> Result<Ordering>

Compare self with other

pub fn flip_sign(&mut self) -> Result<()>

Flip the sign of self

pub fn mp_add(&self, other: &MPI) -> Result<MPI>

Addition operator

pub fn mp_add_assign(&mut self, other: &MPI) -> Result<()>

Addition operator, assignment version

pub fn mp_add_u32(&self, other: u32) -> Result<MPI>

Addition operator

pub fn mp_add_u32_assign(&mut self, other: u32) -> Result<()>

Addition operator, assignment version

pub fn mp_sub(&self, other: &MPI) -> Result<MPI>

Subtraction operator

pub fn mp_sub_assign(&mut self, other: &MPI) -> Result<()>

Subtraction operator, assignment version

pub fn mp_sub_u32(&self, other: u32) -> Result<MPI>

Subtraction operator

pub fn mp_sub_u32_assign(&mut self, other: u32) -> Result<()>

Subtraction operator, assignment version

pub fn mp_mul(&self, other: &MPI) -> Result<MPI>

Multiplication operator

pub fn mp_mul_assign(&mut self, other: &MPI) -> Result<()>

Multiplication operator, assignment version

pub fn mp_shl(&self, shift: usize) -> Result<MPI>

Bitwise left shift

pub fn mp_shl_assign(&mut self, shift: usize) -> Result<()>

Bitwise left shift, assignment version

pub fn mp_shr(&self, shift: usize) -> Result<MPI>

Bitwise right shift

pub fn mp_shr_assign(&mut self, shift: usize) -> Result<()>

Bitwise right shift, assignment version

pub fn divrem(&self, z: &MPI) -> Result<(MPI, MPI)>

Division/modulo operator

pub fn swap(&mut self, other: &mut MPI) -> Result<()>

Swap two MPI values

pub fn is_prime( &self, rng: &mut RandomNumberGenerator, test_prob: usize, ) -> Result<bool>

Perform a primality test on self

Examples

use core::str::FromStr;
let n = botan::MPI::from_str("1111111111111111111").unwrap();
let mut rng = botan::RandomNumberGenerator::new_system().unwrap();
assert!(n.is_prime(&mut rng, 128).unwrap());

pub fn gcd(x: &MPI, y: &MPI) -> Result<MPI>

Return the greatest common divisor of x and y

Examples

use core::str::FromStr;
let x = botan::MPI::from_str("1111111111111111").unwrap();
let y = botan::MPI::from_str("111111111111").unwrap();
assert_eq!(botan::MPI::gcd(&x, &y).unwrap(), botan::MPI::from_str("1111").unwrap());

pub fn modular_inverse(x: &MPI, m: &MPI) -> Result<MPI>

Return the inverse of x modulo m, or 0 if gcd(x,m) > 1

pub fn powmod(x: &MPI, e: &MPI, m: &MPI) -> Result<MPI>

Return (x^e) mod m

Trait Implementations

impl Add<&MPI> for &MPI

type Output = MPI

The resulting type after applying the + operator.

fn add(self, other: &MPI) -> MPI

Performs the + operation.

impl Add<&MPI> for MPI

type Output = MPI

The resulting type after applying the + operator.

fn add(self, other: &MPI) -> MPI

Performs the + operation.

impl Add<u32> for &MPI

type Output = MPI

The resulting type after applying the + operator.

fn add(self, other: u32) -> MPI

Performs the + operation.

impl Add<u32> for MPI

type Output = MPI

The resulting type after applying the + operator.

fn add(self, other: u32) -> MPI

Performs the + operation.

impl AddAssign<&MPI> for MPI

fn add_assign(&mut self, other: &MPI)

Performs the += operation.

impl AddAssign<u32> for MPI

fn add_assign(&mut self, other: u32)

Performs the += operation.

impl Clone for MPI

fn clone(&self) -> MPI

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MPI

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for MPI

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Div<&MPI> for &MPI

type Output = MPI

The resulting type after applying the / operator.

fn div(self, other: &MPI) -> MPI

Performs the / operation.

impl<'a> DivAssign<&'a MPI> for MPI

fn div_assign(&mut self, other: &'a MPI)

Performs the /= operation.

impl Drop for MPI

fn drop(&mut self)

Executes the destructor for this type.

impl FromStr for MPI

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<MPI>

Parses a string s to return a value of this type.

impl LowerHex for MPI

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Mul<&MPI> for &MPI

type Output = MPI

The resulting type after applying the * operator.

fn mul(self, other: &MPI) -> MPI

Performs the * operation.

impl Mul<&MPI> for MPI

type Output = MPI

The resulting type after applying the * operator.

fn mul(self, other: &MPI) -> MPI

Performs the * operation.

impl MulAssign<&MPI> for MPI

fn mul_assign(&mut self, other: &MPI)

Performs the *= operation.

impl Neg for MPI

type Output = MPI

The resulting type after applying the - operator.

fn neg(self) -> MPI

Performs the unary - operation.

impl Ord for MPI

fn cmp(&self, other: &MPI) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for MPI

fn eq(&self, other: &MPI) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for MPI

fn partial_cmp(&self, other: &MPI) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Rem<&MPI> for &MPI

type Output = MPI

The resulting type after applying the % operator.

fn rem(self, other: &MPI) -> MPI

Performs the % operation.

impl RemAssign<&MPI> for MPI

fn rem_assign(&mut self, other: &MPI)

Performs the %= operation.

impl Shl<usize> for &MPI

type Output = MPI

The resulting type after applying the << operator.

fn shl(self, shift: usize) -> MPI

Performs the << operation.

impl ShlAssign<usize> for MPI

fn shl_assign(&mut self, shift: usize)

Performs the <<= operation.

impl Shr<usize> for &MPI

type Output = MPI

The resulting type after applying the >> operator.

fn shr(self, shift: usize) -> MPI

Performs the >> operation.

impl ShrAssign<usize> for MPI

fn shr_assign(&mut self, shift: usize)

Performs the >>= operation.

impl Sub<&MPI> for &MPI

type Output = MPI

The resulting type after applying the - operator.

fn sub(self, other: &MPI) -> MPI

Performs the - operation.

impl Sub<&MPI> for MPI

type Output = MPI

The resulting type after applying the - operator.

fn sub(self, other: &MPI) -> MPI

Performs the - operation.

impl Sub<u32> for &MPI

type Output = MPI

The resulting type after applying the - operator.

fn sub(self, other: u32) -> MPI

Performs the - operation.

impl Sub<u32> for MPI

type Output = MPI

The resulting type after applying the - operator.

fn sub(self, other: u32) -> MPI

Performs the - operation.

impl SubAssign<&MPI> for MPI

fn sub_assign(&mut self, other: &MPI)

Performs the -= operation.

impl SubAssign<u32> for MPI

fn sub_assign(&mut self, other: u32)

Performs the -= operation.

impl UpperHex for MPI

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for MPI

impl Send for MPI

impl Sync for MPI