[−][src]Struct num_bigint::BigUint

[+] Show declaration

pub struct BigUint { /* fields omitted */ }

[−]

A big unsigned integer type.

Implementations

`impl BigUint`[src][−]

`pub fn new(digits: Vec<u32>) -> BigUint`[src][−]

Creates and initializes a BigUint.

The base 2³² digits are ordered least significant digit first.

`pub fn from_slice(slice: &[u32]) -> BigUint`[src][−]

Creates and initializes a BigUint.

The base 2³² digits are ordered least significant digit first.

`pub fn assign_from_slice(&mut self, slice: &[u32])`[src][−]

Assign a value to a BigUint.

The base 2³² digits are ordered least significant digit first.

`pub fn from_bytes_be(bytes: &[u8]) -> BigUint`[src][−]

Creates and initializes a BigUint.

The bytes are in big-endian byte order.

Examples

use num_bigint::BigUint;

assert_eq!(BigUint::from_bytes_be(b"A"),
           BigUint::parse_bytes(b"65", 10).unwrap());
assert_eq!(BigUint::from_bytes_be(b"AA"),
           BigUint::parse_bytes(b"16705", 10).unwrap());
assert_eq!(BigUint::from_bytes_be(b"AB"),
           BigUint::parse_bytes(b"16706", 10).unwrap());
assert_eq!(BigUint::from_bytes_be(b"Hello world!"),
           BigUint::parse_bytes(b"22405534230753963835153736737", 10).unwrap());

`pub fn from_bytes_le(bytes: &[u8]) -> BigUint`[src][−]

Creates and initializes a BigUint.

The bytes are in little-endian byte order.

`pub fn parse_bytes(buf: &[u8], radix: u32) -> Option<BigUint>`[src][−]

Creates and initializes a BigUint. The input slice must contain ascii/utf8 characters in [0-9a-zA-Z]. radix must be in the range 2...36.

The function from_str_radix from the Num trait provides the same logic for &str buffers.

Examples

use num_bigint::{BigUint, ToBigUint};

assert_eq!(BigUint::parse_bytes(b"1234", 10), ToBigUint::to_biguint(&1234));
assert_eq!(BigUint::parse_bytes(b"ABCD", 16), ToBigUint::to_biguint(&0xABCD));
assert_eq!(BigUint::parse_bytes(b"G", 16), None);

`pub fn from_radix_be(buf: &[u8], radix: u32) -> Option<BigUint>`[src][−]

Creates and initializes a BigUint. Each u8 of the input slice is interpreted as one digit of the number and must therefore be less than radix.

The bytes are in big-endian byte order. radix must be in the range 2...256.

Examples

use num_bigint::{BigUint};

let inbase190 = &[15, 33, 125, 12, 14];
let a = BigUint::from_radix_be(inbase190, 190).unwrap();
assert_eq!(a.to_radix_be(190), inbase190);

`pub fn from_radix_le(buf: &[u8], radix: u32) -> Option<BigUint>`[src][−]

Creates and initializes a BigUint. Each u8 of the input slice is interpreted as one digit of the number and must therefore be less than radix.

The bytes are in little-endian byte order. radix must be in the range 2...256.

Examples

use num_bigint::{BigUint};

let inbase190 = &[14, 12, 125, 33, 15];
let a = BigUint::from_radix_be(inbase190, 190).unwrap();
assert_eq!(a.to_radix_be(190), inbase190);

`pub fn to_bytes_be(&self) -> Vec<u8>`[src][−]

Returns the byte representation of the BigUint in big-endian byte order.

Examples

use num_bigint::BigUint;

let i = BigUint::parse_bytes(b"1125", 10).unwrap();
assert_eq!(i.to_bytes_be(), vec![4, 101]);

`pub fn to_bytes_le(&self) -> Vec<u8>`[src][−]

Returns the byte representation of the BigUint in little-endian byte order.

Examples

use num_bigint::BigUint;

let i = BigUint::parse_bytes(b"1125", 10).unwrap();
assert_eq!(i.to_bytes_le(), vec![101, 4]);

`pub fn to_u32_digits(&self) -> Vec<u32>`[src][−]

Returns the u32 digits representation of the BigUint ordered least significant digit first.

Examples

use num_bigint::BigUint;

assert_eq!(BigUint::from(1125u32).to_u32_digits(), vec![1125]);
assert_eq!(BigUint::from(4294967295u32).to_u32_digits(), vec![4294967295]);
assert_eq!(BigUint::from(4294967296u64).to_u32_digits(), vec![0, 1]);
assert_eq!(BigUint::from(112500000000u64).to_u32_digits(), vec![830850304, 26]);

`pub fn to_str_radix(&self, radix: u32) -> String`[src][−]

Returns the integer formatted as a string in the given radix. radix must be in the range 2...36.

Examples

use num_bigint::BigUint;

let i = BigUint::parse_bytes(b"ff", 16).unwrap();
assert_eq!(i.to_str_radix(16), "ff");

`pub fn to_radix_be(&self, radix: u32) -> Vec<u8>`[src][−]

Returns the integer in the requested base in big-endian digit order. The output is not given in a human readable alphabet but as a zero based u8 number. radix must be in the range 2...256.

Examples

use num_bigint::BigUint;

assert_eq!(BigUint::from(0xFFFFu64).to_radix_be(159),
           vec![2, 94, 27]);
// 0xFFFF = 65535 = 2*(159^2) + 94*159 + 27

`pub fn to_radix_le(&self, radix: u32) -> Vec<u8>`[src][−]

Returns the integer in the requested base in little-endian digit order. The output is not given in a human readable alphabet but as a zero based u8 number. radix must be in the range 2...256.

Examples

use num_bigint::BigUint;

assert_eq!(BigUint::from(0xFFFFu64).to_radix_le(159),
           vec![27, 94, 2]);
// 0xFFFF = 65535 = 27 + 94*159 + 2*(159^2)

`pub fn bits(&self) -> usize`[src][−]

Determines the fewest bits necessary to express the BigUint.

`pub fn modpow(&self, exponent: &Self, modulus: &Self) -> Self`[src][−]

Returns (self ^ exponent) % modulus.

Panics if the modulus is zero.

`pub fn sqrt(&self) -> Self`[src][−]

Returns the truncated principal square root of self -- see Roots::sqrt

`pub fn cbrt(&self) -> Self`[src][−]

Returns the truncated principal cube root of self -- see Roots::cbrt.

`pub fn nth_root(&self, n: u32) -> Self`[src][−]

Returns the truncated principal nth root of self -- see Roots::nth_root.

[−][src]Struct num_bigint::BigUint

Implementations

impl BigUint[src][−]

pub fn new(digits: Vec<u32>) -> BigUint[src][−]

pub fn from_slice(slice: &[u32]) -> BigUint[src][−]

pub fn assign_from_slice(&mut self, slice: &[u32])[src][−]

pub fn from_bytes_be(bytes: &[u8]) -> BigUint[src][−]

pub fn from_bytes_le(bytes: &[u8]) -> BigUint[src][−]

pub fn parse_bytes(buf: &[u8], radix: u32) -> Option<BigUint>[src][−]

pub fn from_radix_be(buf: &[u8], radix: u32) -> Option<BigUint>[src][−]

pub fn from_radix_le(buf: &[u8], radix: u32) -> Option<BigUint>[src][−]

pub fn to_bytes_be(&self) -> Vec<u8>[src][−]

pub fn to_bytes_le(&self) -> Vec<u8>[src][−]

pub fn to_u32_digits(&self) -> Vec<u32>[src][−]

pub fn to_str_radix(&self, radix: u32) -> String[src][−]

pub fn to_radix_be(&self, radix: u32) -> Vec<u8>[src][−]

pub fn to_radix_le(&self, radix: u32) -> Vec<u8>[src][−]

pub fn bits(&self) -> usize[src][−]

pub fn modpow(&self, exponent: &Self, modulus: &Self) -> Self[src][−]

pub fn sqrt(&self) -> Self[src][−]

pub fn cbrt(&self) -> Self[src][−]

pub fn nth_root(&self, n: u32) -> Self[src][−]

Trait Implementations

impl<'a> Add<&'a BigUint> for BigUint[src][+]

type Output = BigUint

fn add(self, other: &BigUint) -> BigUint[src][−]

impl<'a> Add<&'a BigUint> for u8[src][+]

type Output = BigUint

fn add(self, other: &BigUint) -> BigUint[src][−]

impl<'a, 'b> Add<&'a BigUint> for &'b u64[src][+]

type Output = BigUint

fn add(self, other: &BigUint) -> BigUint[src][−]

impl<'a> Add<&'a BigUint> for u128[src][+]

type Output = BigUint

fn add(self, other: &BigUint) -> BigUint[src][−]

impl<'a, 'b> Add<&'a BigUint> for &'b u128[src][+]

type Output = BigUint

fn add(self, other: &BigUint) -> BigUint[src][−]

impl<'a, 'b> Add<&'a BigUint> for &'b u8[src][+]

type Output = BigUint

fn add(self, other: &BigUint) -> BigUint[src][−]

impl<'a> Add<&'a BigUint> for u16[src][+]

type Output = BigUint

fn add(self, other: &BigUint) -> BigUint[src][−]

impl<'a, 'b> Add<&'a BigUint> for &'b u16[src][+]

type Output = BigUint

fn add(self, other: &BigUint) -> BigUint[src][−]

impl<'a> Add<&'a BigUint> for usize[src][+]

type Output = BigUint

fn add(self, other: &BigUint) -> BigUint[src][−]

impl<'a, 'b> Add<&'a BigUint> for &'b usize[src][+]

type Output = BigUint

fn add(self, other: &BigUint) -> BigUint[src][−]

impl<'a> Add<&'a BigUint> for u32[src][+]

type Output = BigUint

fn add(self, other: &BigUint) -> BigUint[src][−]

impl<'a, 'b> Add<&'a BigUint> for &'b u32[src][+]

type Output = BigUint

fn add(self, other: &BigUint) -> BigUint[src][−]

impl<'a> Add<&'a BigUint> for u64[src][+]

type Output = BigUint

fn add(self, other: &BigUint) -> BigUint[src][−]

impl<'a> Add<&'a u128> for BigUint[src][+]

type Output = BigUint

fn add(self, other: &u128) -> BigUint[src][−]

impl<'a> Add<&'a u16> for BigUint[src][+]

type Output = BigUint

fn add(self, other: &u16) -> BigUint[src][−]

impl<'a> Add<&'a u32> for BigUint[src][+]

type Output = BigUint

fn add(self, other: &u32) -> BigUint[src][−]

impl<'a> Add<&'a u64> for BigUint[src][+]

type Output = BigUint

fn add(self, other: &u64) -> BigUint[src][−]

impl<'a> Add<&'a u8> for BigUint[src][+]

type Output = BigUint

fn add(self, other: &u8) -> BigUint[src][−]

impl<'a> Add<&'a usize> for BigUint[src][+]

type Output = BigUint

fn add(self, other: &usize) -> BigUint[src][−]

`impl BigUint`[src][−]

`pub fn new(digits: Vec<u32>) -> BigUint`[src][−]

`pub fn from_slice(slice: &[u32]) -> BigUint`[src][−]

`pub fn assign_from_slice(&mut self, slice: &[u32])`[src][−]

`pub fn from_bytes_be(bytes: &[u8]) -> BigUint`[src][−]

`pub fn from_bytes_le(bytes: &[u8]) -> BigUint`[src][−]

`pub fn parse_bytes(buf: &[u8], radix: u32) -> Option<BigUint>`[src][−]

`pub fn from_radix_be(buf: &[u8], radix: u32) -> Option<BigUint>`[src][−]

`pub fn from_radix_le(buf: &[u8], radix: u32) -> Option<BigUint>`[src][−]

`pub fn to_bytes_be(&self) -> Vec<u8>`[src][−]

`pub fn to_bytes_le(&self) -> Vec<u8>`[src][−]

`pub fn to_u32_digits(&self) -> Vec<u32>`[src][−]

`pub fn to_str_radix(&self, radix: u32) -> String`[src][−]

`pub fn to_radix_be(&self, radix: u32) -> Vec<u8>`[src][−]

`pub fn to_radix_le(&self, radix: u32) -> Vec<u8>`[src][−]

`pub fn bits(&self) -> usize`[src][−]

`pub fn modpow(&self, exponent: &Self, modulus: &Self) -> Self`[src][−]

`pub fn sqrt(&self) -> Self`[src][−]

`pub fn cbrt(&self) -> Self`[src][−]

`pub fn nth_root(&self, n: u32) -> Self`[src][−]

`impl<'a> Add<&'a BigUint> for BigUint`[src][+]

`type Output = BigUint`

`fn add(self, other: &BigUint) -> BigUint`[src][−]

`impl<'a> Add<&'a BigUint> for u8`[src][+]

`type Output = BigUint`

`fn add(self, other: &BigUint) -> BigUint`[src][−]

`impl<'a, 'b> Add<&'a BigUint> for &'b u64`[src][+]

`type Output = BigUint`

`fn add(self, other: &BigUint) -> BigUint`[src][−]

`impl<'a> Add<&'a BigUint> for u128`[src][+]

`type Output = BigUint`

`fn add(self, other: &BigUint) -> BigUint`[src][−]

`impl<'a, 'b> Add<&'a BigUint> for &'b u128`[src][+]

`type Output = BigUint`

`fn add(self, other: &BigUint) -> BigUint`[src][−]

`impl<'a, 'b> Add<&'a BigUint> for &'b u8`[src][+]

`type Output = BigUint`

`fn add(self, other: &BigUint) -> BigUint`[src][−]

`impl<'a> Add<&'a BigUint> for u16`[src][+]

`type Output = BigUint`

`fn add(self, other: &BigUint) -> BigUint`[src][−]

`impl<'a, 'b> Add<&'a BigUint> for &'b u16`[src][+]

`type Output = BigUint`

`fn add(self, other: &BigUint) -> BigUint`[src][−]

`impl<'a> Add<&'a BigUint> for usize`[src][+]

`type Output = BigUint`

`fn add(self, other: &BigUint) -> BigUint`[src][−]

`impl<'a, 'b> Add<&'a BigUint> for &'b usize`[src][+]

`type Output = BigUint`

`fn add(self, other: &BigUint) -> BigUint`[src][−]

`impl<'a> Add<&'a BigUint> for u32`[src][+]

`type Output = BigUint`

`fn add(self, other: &BigUint) -> BigUint`[src][−]

`impl<'a, 'b> Add<&'a BigUint> for &'b u32`[src][+]

`type Output = BigUint`

`fn add(self, other: &BigUint) -> BigUint`[src][−]

`impl<'a> Add<&'a BigUint> for u64`[src][+]

`type Output = BigUint`

`fn add(self, other: &BigUint) -> BigUint`[src][−]

`impl<'a> Add<&'a u128> for BigUint`[src][+]

`type Output = BigUint`

`fn add(self, other: &u128) -> BigUint`[src][−]

`impl<'a> Add<&'a u16> for BigUint`[src][+]

`type Output = BigUint`

`fn add(self, other: &u16) -> BigUint`[src][−]

`impl<'a> Add<&'a u32> for BigUint`[src][+]

`type Output = BigUint`

`fn add(self, other: &u32) -> BigUint`[src][−]

`impl<'a> Add<&'a u64> for BigUint`[src][+]

`type Output = BigUint`

`fn add(self, other: &u64) -> BigUint`[src][−]

`impl<'a> Add<&'a u8> for BigUint`[src][+]

`type Output = BigUint`

`fn add(self, other: &u8) -> BigUint`[src][−]

`impl<'a> Add<&'a usize> for BigUint`[src][+]

`type Output = BigUint`

`fn add(self, other: &usize) -> BigUint`[src][−]

`impl<'a, 'b> Add<&'b BigUint> for &'a BigUint`[src][+]

`type Output = BigUint`

`fn add(self, other: &BigUint) -> BigUint`[src][−]