Struct ssh_key::MPInt

pub struct MPInt { /* fields omitted */ }

This is supported on crate feature alloc only.

Multiple precision integer, a.k.a. “mpint”.

This type is used for representing the big integer components of DSA and RSA keys.

Described in RFC4251 § 5:

Represents multiple precision integers in two’s complement format, stored as a string, 8 bits per byte, MSB first. Negative numbers have the value 1 as the most significant bit of the first byte of the data partition. If the most significant bit would be set for a positive number, the number MUST be preceded by a zero byte. Unnecessary leading bytes with the value 0 or 255 MUST NOT be included. The value zero MUST be stored as a string with zero bytes of data.

By convention, a number that is used in modular computations in Z_n SHOULD be represented in the range 0 <= x < n.

Examples

value (hex)	representation (hex)
0	00 00 00 00
9a378f9b2e332a7	00 00 00 08 09 a3 78 f9 b2 e3 32 a7
80	00 00 00 02 00 80
-1234	00 00 00 02 ed cc
-deadbeef	00 00 00 05 ff 21 52 41 11

Implementations

impl MPInt

pub fn from_bytes(bytes: &[u8]) -> Result<Self>

Create a new multiple precision integer from the given big endian-encoded byte slice.

pub fn as_bytes(&self) -> &[u8]

Get the big integer data encoded as big endian bytes.

Trait Implementations

impl AsRef<[u8]> for MPInt

fn as_ref(&self) -> &[u8]

Performs the conversion.

impl Clone for MPInt

fn clone(&self) -> MPInt

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for MPInt

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

Formats the value using the given formatter.

impl Display for MPInt

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

Formats the value using the given formatter.

impl LowerHex for MPInt

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

Formats the value using the given formatter.

impl Ord for MPInt

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

This method returns an Ordering between self and other.

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

Compares and returns the maximum of two values.

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

Compares and returns the minimum of two values.

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

Restrict a value to a certain interval.

impl PartialEq<MPInt> for MPInt

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl PartialOrd<MPInt> for MPInt

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

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

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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

impl TryFrom<Vec<u8, Global>> for MPInt

type Error = Error

The type returned in the event of a conversion error.

fn try_from(bytes: Vec<u8>) -> Result<Self>

Performs the conversion.

impl UpperHex for MPInt

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

Formats the value using the given formatter.

impl Eq for MPInt

impl StructuralEq for MPInt

impl StructuralPartialEq for MPInt