# 1.26.0[−]Primitive Type i128

The 128-bit signed integer type.

See also the `std::i128` module.

## Methods

### `impl i128`[src]

#### `pub const fn min_value() -> i128`1.0.0[src]

Returns the smallest value that can be represented by this integer type.

# Examples

Basic usage:

`assert_eq!(i128::min_value(), -170141183460469231731687303715884105728);Run`

#### `pub const fn max_value() -> i128`1.0.0[src]

Returns the largest value that can be represented by this integer type.

# Examples

Basic usage:

`assert_eq!(i128::max_value(), 170141183460469231731687303715884105727);Run`

#### `pub fn from_str_radix(src: &str, radix: u32) -> Result<i128, ParseIntError>`1.0.0[src]

Converts a string slice in a given base to an integer.

The string is expected to be an optional `+` or `-` sign followed by digits. Leading and trailing whitespace represent an error. Digits are a subset of these characters, depending on `radix`:

• `0-9`
• `a-z`
• `A-Z`

# Panics

This function panics if `radix` is not in the range from 2 to 36.

# Examples

Basic usage:

`assert_eq!(i128::from_str_radix("A", 16), Ok(10));Run`

#### `pub const fn count_ones(self) -> u32`1.0.0[src]

Returns the number of ones in the binary representation of `self`.

# Examples

Basic usage:

```let n = 0b100_0000i128;

assert_eq!(n.count_ones(), 1);Run```

#### `pub const fn count_zeros(self) -> u32`1.0.0[src]

Returns the number of zeros in the binary representation of `self`.

# Examples

Basic usage:

`assert_eq!(i128::max_value().count_zeros(), 1);Run`

#### `pub const fn leading_zeros(self) -> u32`1.0.0[src]

Returns the number of leading zeros in the binary representation of `self`.

# Examples

Basic usage:

```let n = -1i128;

#### `pub const fn trailing_zeros(self) -> u32`1.0.0[src]

Returns the number of trailing zeros in the binary representation of `self`.

# Examples

Basic usage:

```let n = -4i128;

assert_eq!(n.trailing_zeros(), 2);Run```

#### `pub const fn rotate_left(self, n: u32) -> i128`1.0.0[src]

Shifts the bits to the left by a specified amount, `n`, wrapping the truncated bits to the end of the resulting integer.

Please note this isn't the same operation as `<<`!

# Examples

Basic usage:

```let n = 0x13f40000000000000000000000004f76i128;
let m = 0x4f7613f4;

assert_eq!(n.rotate_left(16), m);Run```

#### `pub const fn rotate_right(self, n: u32) -> i128`1.0.0[src]

Shifts the bits to the right by a specified amount, `n`, wrapping the truncated bits to the beginning of the resulting integer.

Please note this isn't the same operation as `>>`!

# Examples

Basic usage:

```let n = 0x4f7613f4i128;
let m = 0x13f40000000000000000000000004f76;

assert_eq!(n.rotate_right(16), m);Run```

#### `pub const fn swap_bytes(self) -> i128`1.0.0[src]

Reverses the byte order of the integer.

# Examples

Basic usage:

```let n = 0x12345678901234567890123456789012i128;

let m = n.swap_bytes();

assert_eq!(m, 0x12907856341290785634129078563412);Run```

#### `pub const fn reverse_bits(self) -> i128`[src]

🔬 This is a nightly-only experimental API. (`reverse_bits `#48763)

Reverses the bit pattern of the integer.

# Examples

Basic usage:

```#![feature(reverse_bits)]

let n = 0x12345678901234567890123456789012i128;
let m = n.reverse_bits();

assert_eq!(m, 0x48091e6a2c48091e6a2c48091e6a2c48);Run```

#### `pub const fn from_be(x: i128) -> i128`1.0.0[src]

Converts an integer from big endian to the target's endianness.

On big endian this is a no-op. On little endian the bytes are swapped.

# Examples

Basic usage:

```let n = 0x1Ai128;

if cfg!(target_endian = "big") {
assert_eq!(i128::from_be(n), n)
} else {
assert_eq!(i128::from_be(n), n.swap_bytes())
}Run```

#### `pub const fn from_le(x: i128) -> i128`1.0.0[src]

Converts an integer from little endian to the target's endianness.

On little endian this is a no-op. On big endian the bytes are swapped.

# Examples

Basic usage:

```let n = 0x1Ai128;

if cfg!(target_endian = "little") {
assert_eq!(i128::from_le(n), n)
} else {
assert_eq!(i128::from_le(n), n.swap_bytes())
}Run```

#### `pub const fn to_be(self) -> i128`1.0.0[src]

Converts `self` to big endian from the target's endianness.

On big endian this is a no-op. On little endian the bytes are swapped.

# Examples

Basic usage:

```let n = 0x1Ai128;

if cfg!(target_endian = "big") {
assert_eq!(n.to_be(), n)
} else {
assert_eq!(n.to_be(), n.swap_bytes())
}Run```

#### `pub const fn to_le(self) -> i128`1.0.0[src]

Converts `self` to little endian from the target's endianness.

On little endian this is a no-op. On big endian the bytes are swapped.

# Examples

Basic usage:

```let n = 0x1Ai128;

if cfg!(target_endian = "little") {
assert_eq!(n.to_le(), n)
} else {
assert_eq!(n.to_le(), n.swap_bytes())
}Run```

#### `pub fn checked_add(self, rhs: i128) -> Option<i128>`1.0.0[src]

Checked integer addition. Computes `self + rhs`, returning `None` if overflow occurred.

# Examples

Basic usage:

```assert_eq!((i128::max_value() - 2).checked_add(1), Some(i128::max_value() - 1));

#### `pub fn checked_sub(self, rhs: i128) -> Option<i128>`1.0.0[src]

Checked integer subtraction. Computes `self - rhs`, returning `None` if overflow occurred.

# Examples

Basic usage:

```assert_eq!((i128::min_value() + 2).checked_sub(1), Some(i128::min_value() + 1));
assert_eq!((i128::min_value() + 2).checked_sub(3), None);Run```

#### `pub fn checked_mul(self, rhs: i128) -> Option<i128>`1.0.0[src]

Checked integer multiplication. Computes `self * rhs`, returning `None` if overflow occurred.

# Examples

Basic usage:

```assert_eq!(i128::max_value().checked_mul(1), Some(i128::max_value()));
assert_eq!(i128::max_value().checked_mul(2), None);Run```

#### `pub fn checked_div(self, rhs: i128) -> Option<i128>`1.0.0[src]

Checked integer division. Computes `self / rhs`, returning `None` if `rhs == 0` or the division results in overflow.

# Examples

Basic usage:

```assert_eq!((i128::min_value() + 1).checked_div(-1), Some(170141183460469231731687303715884105727));
assert_eq!(i128::min_value().checked_div(-1), None);
assert_eq!((1i128).checked_div(0), None);Run```

#### `pub fn checked_div_euc(self, rhs: i128) -> Option<i128>`[src]

🔬 This is a nightly-only experimental API. (`euclidean_division `#49048)

Checked Euclidean division. Computes `self.div_euc(rhs)`, returning `None` if `rhs == 0` or the division results in overflow.

# Examples

Basic usage:

```#![feature(euclidean_division)]
assert_eq!((i128::min_value() + 1).checked_div_euc(-1), Some(170141183460469231731687303715884105727));
assert_eq!(i128::min_value().checked_div_euc(-1), None);
assert_eq!((1i128).checked_div_euc(0), None);Run```

#### `pub fn checked_rem(self, rhs: i128) -> Option<i128>`1.7.0[src]

Checked integer remainder. Computes `self % rhs`, returning `None` if `rhs == 0` or the division results in overflow.

# Examples

Basic usage:

```use std::i128;

assert_eq!(5i128.checked_rem(2), Some(1));
assert_eq!(5i128.checked_rem(0), None);
assert_eq!(i128::MIN.checked_rem(-1), None);Run```

#### `pub fn checked_mod_euc(self, rhs: i128) -> Option<i128>`[src]

🔬 This is a nightly-only experimental API. (`euclidean_division `#49048)

Checked Euclidean modulo. Computes `self.mod_euc(rhs)`, returning `None` if `rhs == 0` or the division results in overflow.

# Examples

Basic usage:

```#![feature(euclidean_division)]
use std::i128;

assert_eq!(5i128.checked_mod_euc(2), Some(1));
assert_eq!(5i128.checked_mod_euc(0), None);
assert_eq!(i128::MIN.checked_mod_euc(-1), None);Run```

#### `pub fn checked_neg(self) -> Option<i128>`1.7.0[src]

Checked negation. Computes `-self`, returning `None` if `self == MIN`.

# Examples

Basic usage:

```use std::i128;

assert_eq!(5i128.checked_neg(), Some(-5));
assert_eq!(i128::MIN.checked_neg(), None);Run```

#### `pub fn checked_shl(self, rhs: u32) -> Option<i128>`1.7.0[src]

Checked shift left. Computes `self << rhs`, returning `None` if `rhs` is larger than or equal to the number of bits in `self`.

# Examples

Basic usage:

```assert_eq!(0x1i128.checked_shl(4), Some(0x10));
assert_eq!(0x1i128.checked_shl(129), None);Run```

#### `pub fn checked_shr(self, rhs: u32) -> Option<i128>`1.7.0[src]

Checked shift right. Computes `self >> rhs`, returning `None` if `rhs` is larger than or equal to the number of bits in `self`.

# Examples

Basic usage:

```assert_eq!(0x10i128.checked_shr(4), Some(0x1));
assert_eq!(0x10i128.checked_shr(128), None);Run```

#### `pub fn checked_abs(self) -> Option<i128>`1.13.0[src]

Checked absolute value. Computes `self.abs()`, returning `None` if `self == MIN`.

# Examples

Basic usage:

```use std::i128;

assert_eq!((-5i128).checked_abs(), Some(5));
assert_eq!(i128::MIN.checked_abs(), None);Run```

#### `pub fn checked_pow(self, exp: u32) -> Option<i128>`[src]

🔬 This is a nightly-only experimental API. (`no_panic_pow `#48320)

Checked exponentiation. Computes `self.pow(exp)`, returning `None` if overflow occurred.

# Examples

Basic usage:

```#![feature(no_panic_pow)]
assert_eq!(8i128.checked_pow(2), Some(64));
assert_eq!(i128::max_value().checked_pow(2), None);Run```

#### `pub fn saturating_add(self, rhs: i128) -> i128`1.0.0[src]

Saturating integer addition. Computes `self + rhs`, saturating at the numeric bounds instead of overflowing.

# Examples

Basic usage:

```assert_eq!(100i128.saturating_add(1), 101);

#### `pub fn saturating_sub(self, rhs: i128) -> i128`1.0.0[src]

Saturating integer subtraction. Computes `self - rhs`, saturating at the numeric bounds instead of overflowing.

# Examples

Basic usage:

```assert_eq!(100i128.saturating_sub(127), -27);
assert_eq!(i128::min_value().saturating_sub(100), i128::min_value());Run```

#### `pub fn saturating_mul(self, rhs: i128) -> i128`1.7.0[src]

Saturating integer multiplication. Computes `self * rhs`, saturating at the numeric bounds instead of overflowing.

# Examples

Basic usage:

```use std::i128;

assert_eq!(10i128.saturating_mul(12), 120);
assert_eq!(i128::MAX.saturating_mul(10), i128::MAX);
assert_eq!(i128::MIN.saturating_mul(10), i128::MIN);Run```

#### `pub fn saturating_pow(self, exp: u32) -> i128`[src]

🔬 This is a nightly-only experimental API. (`no_panic_pow `#48320)

Saturating integer exponentiation. Computes `self.pow(exp)`, saturating at the numeric bounds instead of overflowing.

# Examples

Basic usage:

```#![feature(no_panic_pow)]
use std::i128;

assert_eq!((-4i128).saturating_pow(3), -64);
assert_eq!(i128::MIN.saturating_pow(2), i128::MAX);
assert_eq!(i128::MIN.saturating_pow(3), i128::MIN);Run```

#### `pub const fn wrapping_add(self, rhs: i128) -> i128`1.0.0[src]

Wrapping (modular) addition. Computes `self + rhs`, wrapping around at the boundary of the type.

# Examples

Basic usage:

```assert_eq!(100i128.wrapping_add(27), 127);

#### `pub const fn wrapping_sub(self, rhs: i128) -> i128`1.0.0[src]

Wrapping (modular) subtraction. Computes `self - rhs`, wrapping around at the boundary of the type.

# Examples

Basic usage:

```assert_eq!(0i128.wrapping_sub(127), -127);
assert_eq!((-2i128).wrapping_sub(i128::max_value()), i128::max_value());Run```

#### `pub const fn wrapping_mul(self, rhs: i128) -> i128`1.0.0[src]

Wrapping (modular) multiplication. Computes `self * rhs`, wrapping around at the boundary of the type.

# Examples

Basic usage:

```assert_eq!(10i128.wrapping_mul(12), 120);
assert_eq!(11i8.wrapping_mul(12), -124);Run```

#### `pub fn wrapping_div(self, rhs: i128) -> i128`1.2.0[src]

Wrapping (modular) division. Computes `self / rhs`, wrapping around at the boundary of the type.

The only case where such wrapping can occur is when one divides `MIN / -1` on a signed type (where `MIN` is the negative minimal value for the type); this is equivalent to `-MIN`, a positive value that is too large to represent in the type. In such a case, this function returns `MIN` itself.

# Panics

This function will panic if `rhs` is 0.

# Examples

Basic usage:

```assert_eq!(100i128.wrapping_div(10), 10);
assert_eq!((-128i8).wrapping_div(-1), -128);Run```

#### `pub fn wrapping_div_euc(self, rhs: i128) -> i128`[src]

🔬 This is a nightly-only experimental API. (`euclidean_division `#49048)

Wrapping Euclidean division. Computes `self.div_euc(rhs)`, wrapping around at the boundary of the type.

Wrapping will only occur in `MIN / -1` on a signed type (where `MIN` is the negative minimal value for the type). This is equivalent to `-MIN`, a positive value that is too large to represent in the type. In this case, this method returns `MIN` itself.

# Panics

This function will panic if `rhs` is 0.

# Examples

Basic usage:

```#![feature(euclidean_division)]
assert_eq!(100i128.wrapping_div_euc(10), 10);
assert_eq!((-128i8).wrapping_div_euc(-1), -128);Run```

#### `pub fn wrapping_rem(self, rhs: i128) -> i128`1.2.0[src]

Wrapping (modular) remainder. Computes `self % rhs`, wrapping around at the boundary of the type.

Such wrap-around never actually occurs mathematically; implementation artifacts make `x % y` invalid for `MIN / -1` on a signed type (where `MIN` is the negative minimal value). In such a case, this function returns `0`.

# Panics

This function will panic if `rhs` is 0.

# Examples

Basic usage:

```assert_eq!(100i128.wrapping_rem(10), 0);
assert_eq!((-128i8).wrapping_rem(-1), 0);Run```

#### `pub fn wrapping_mod_euc(self, rhs: i128) -> i128`[src]

🔬 This is a nightly-only experimental API. (`euclidean_division `#49048)

Wrapping Euclidean modulo. Computes `self.mod_euc(rhs)`, wrapping around at the boundary of the type.

Wrapping will only occur in `MIN % -1` on a signed type (where `MIN` is the negative minimal value for the type). In this case, this method returns 0.

# Panics

This function will panic if `rhs` is 0.

# Examples

Basic usage:

```#![feature(euclidean_division)]
assert_eq!(100i128.wrapping_mod_euc(10), 0);
assert_eq!((-128i8).wrapping_mod_euc(-1), 0);Run```

#### `pub fn wrapping_neg(self) -> i128`1.2.0[src]

Wrapping (modular) negation. Computes `-self`, wrapping around at the boundary of the type.

The only case where such wrapping can occur is when one negates `MIN` on a signed type (where `MIN` is the negative minimal value for the type); this is a positive value that is too large to represent in the type. In such a case, this function returns `MIN` itself.

# Examples

Basic usage:

```assert_eq!(100i128.wrapping_neg(), -100);
assert_eq!(i128::min_value().wrapping_neg(), i128::min_value());Run```

#### `pub const fn wrapping_shl(self, rhs: u32) -> i128`1.2.0[src]

Panic-free bitwise shift-left; yields `self << mask(rhs)`, where `mask` removes any high-order bits of `rhs` that would cause the shift to exceed the bitwidth of the type.

Note that this is not the same as a rotate-left; the RHS of a wrapping shift-left is restricted to the range of the type, rather than the bits shifted out of the LHS being returned to the other end. The primitive integer types all implement a `rotate_left` function, which may be what you want instead.

# Examples

Basic usage:

```assert_eq!((-1i128).wrapping_shl(7), -128);
assert_eq!((-1i128).wrapping_shl(128), -1);Run```

#### `pub const fn wrapping_shr(self, rhs: u32) -> i128`1.2.0[src]

Panic-free bitwise shift-right; yields `self >> mask(rhs)`, where `mask` removes any high-order bits of `rhs` that would cause the shift to exceed the bitwidth of the type.

Note that this is not the same as a rotate-right; the RHS of a wrapping shift-right is restricted to the range of the type, rather than the bits shifted out of the LHS being returned to the other end. The primitive integer types all implement a `rotate_right` function, which may be what you want instead.

# Examples

Basic usage:

```assert_eq!((-128i128).wrapping_shr(7), -1);
assert_eq!((-128i16).wrapping_shr(64), -128);Run```

#### `pub fn wrapping_abs(self) -> i128`1.13.0[src]

Wrapping (modular) absolute value. Computes `self.abs()`, wrapping around at the boundary of the type.

The only case where such wrapping can occur is when one takes the absolute value of the negative minimal value for the type this is a positive value that is too large to represent in the type. In such a case, this function returns `MIN` itself.

# Examples

Basic usage:

```assert_eq!(100i128.wrapping_abs(), 100);
assert_eq!((-100i128).wrapping_abs(), 100);
assert_eq!(i128::min_value().wrapping_abs(), i128::min_value());
assert_eq!((-128i8).wrapping_abs() as u8, 128);Run```

#### `pub fn wrapping_pow(self, exp: u32) -> i128`[src]

🔬 This is a nightly-only experimental API. (`no_panic_pow `#48320)

Wrapping (modular) exponentiation. Computes `self.pow(exp)`, wrapping around at the boundary of the type.

# Examples

Basic usage:

```#![feature(no_panic_pow)]
assert_eq!(3i128.wrapping_pow(4), 81);
assert_eq!(3i8.wrapping_pow(5), -13);
assert_eq!(3i8.wrapping_pow(6), -39);Run```

#### `pub const fn overflowing_add(self, rhs: i128) -> (i128, bool)`1.7.0[src]

Calculates `self` + `rhs`

Returns a tuple of the addition along with a boolean indicating whether an arithmetic overflow would occur. If an overflow would have occurred then the wrapped value is returned.

# Examples

Basic usage:

```use std::i128;

#### `pub const fn overflowing_sub(self, rhs: i128) -> (i128, bool)`1.7.0[src]

Calculates `self` - `rhs`

Returns a tuple of the subtraction along with a boolean indicating whether an arithmetic overflow would occur. If an overflow would have occurred then the wrapped value is returned.

# Examples

Basic usage:

```use std::i128;

assert_eq!(5i128.overflowing_sub(2), (3, false));
assert_eq!(i128::MIN.overflowing_sub(1), (i128::MAX, true));Run```

#### `pub const fn overflowing_mul(self, rhs: i128) -> (i128, bool)`1.7.0[src]

Calculates the multiplication of `self` and `rhs`.

Returns a tuple of the multiplication along with a boolean indicating whether an arithmetic overflow would occur. If an overflow would have occurred then the wrapped value is returned.

# Examples

Basic usage:

```assert_eq!(5i128.overflowing_mul(2), (10, false));
assert_eq!(1_000_000_000i32.overflowing_mul(10), (1410065408, true));Run```

#### `pub fn overflowing_div(self, rhs: i128) -> (i128, bool)`1.7.0[src]

Calculates the divisor when `self` is divided by `rhs`.

Returns a tuple of the divisor along with a boolean indicating whether an arithmetic overflow would occur. If an overflow would occur then self is returned.

# Panics

This function will panic if `rhs` is 0.

# Examples

Basic usage:

```use std::i128;

assert_eq!(5i128.overflowing_div(2), (2, false));
assert_eq!(i128::MIN.overflowing_div(-1), (i128::MIN, true));Run```

#### `pub fn overflowing_div_euc(self, rhs: i128) -> (i128, bool)`[src]

🔬 This is a nightly-only experimental API. (`euclidean_division `#49048)

Calculates the quotient of Euclidean division `self.div_euc(rhs)`.

Returns a tuple of the divisor along with a boolean indicating whether an arithmetic overflow would occur. If an overflow would occur then `self` is returned.

# Panics

This function will panic if `rhs` is 0.

# Examples

Basic usage:

```#![feature(euclidean_division)]
use std::i128;

assert_eq!(5i128.overflowing_div_euc(2), (2, false));
assert_eq!(i128::MIN.overflowing_div_euc(-1), (i128::MIN, true));Run```

#### `pub fn overflowing_rem(self, rhs: i128) -> (i128, bool)`1.7.0[src]

Calculates the remainder when `self` is divided by `rhs`.

Returns a tuple of the remainder after dividing along with a boolean indicating whether an arithmetic overflow would occur. If an overflow would occur then 0 is returned.

# Panics

This function will panic if `rhs` is 0.

# Examples

Basic usage:

```use std::i128;

assert_eq!(5i128.overflowing_rem(2), (1, false));
assert_eq!(i128::MIN.overflowing_rem(-1), (0, true));Run```

#### `pub fn overflowing_mod_euc(self, rhs: i128) -> (i128, bool)`[src]

🔬 This is a nightly-only experimental API. (`euclidean_division `#49048)

Calculates the remainder `self.mod_euc(rhs)` by Euclidean division.

Returns a tuple of the remainder after dividing along with a boolean indicating whether an arithmetic overflow would occur. If an overflow would occur then 0 is returned.

# Panics

This function will panic if `rhs` is 0.

# Examples

Basic usage:

```#![feature(euclidean_division)]
use std::i128;

assert_eq!(5i128.overflowing_mod_euc(2), (1, false));
assert_eq!(i128::MIN.overflowing_mod_euc(-1), (0, true));Run```

#### `pub fn overflowing_neg(self) -> (i128, bool)`1.7.0[src]

Negates self, overflowing if this is equal to the minimum value.

Returns a tuple of the negated version of self along with a boolean indicating whether an overflow happened. If `self` is the minimum value (e.g. `i32::MIN` for values of type `i32`), then the minimum value will be returned again and `true` will be returned for an overflow happening.

# Examples

Basic usage:

```use std::i128;

assert_eq!(2i128.overflowing_neg(), (-2, false));
assert_eq!(i128::MIN.overflowing_neg(), (i128::MIN, true));Run```

#### `pub const fn overflowing_shl(self, rhs: u32) -> (i128, bool)`1.7.0[src]

Shifts self left by `rhs` bits.

Returns a tuple of the shifted version of self along with a boolean indicating whether the shift value was larger than or equal to the number of bits. If the shift value is too large, then value is masked (N-1) where N is the number of bits, and this value is then used to perform the shift.

# Examples

Basic usage:

```assert_eq!(0x1i128.overflowing_shl(4), (0x10, false));
assert_eq!(0x1i32.overflowing_shl(36), (0x10, true));Run```

#### `pub const fn overflowing_shr(self, rhs: u32) -> (i128, bool)`1.7.0[src]

Shifts self right by `rhs` bits.

Returns a tuple of the shifted version of self along with a boolean indicating whether the shift value was larger than or equal to the number of bits. If the shift value is too large, then value is masked (N-1) where N is the number of bits, and this value is then used to perform the shift.

# Examples

Basic usage:

```assert_eq!(0x10i128.overflowing_shr(4), (0x1, false));
assert_eq!(0x10i32.overflowing_shr(36), (0x1, true));Run```

#### `pub fn overflowing_abs(self) -> (i128, bool)`1.13.0[src]

Computes the absolute value of `self`.

Returns a tuple of the absolute version of self along with a boolean indicating whether an overflow happened. If self is the minimum value (e.g. i128::MIN for values of type i128), then the minimum value will be returned again and true will be returned for an overflow happening.

# Examples

Basic usage:

```assert_eq!(10i128.overflowing_abs(), (10, false));
assert_eq!((-10i128).overflowing_abs(), (10, false));
assert_eq!((i128::min_value()).overflowing_abs(), (i128::min_value(), true));Run```

#### `pub fn overflowing_pow(self, exp: u32) -> (i128, bool)`[src]

🔬 This is a nightly-only experimental API. (`no_panic_pow `#48320)

Raises self to the power of `exp`, using exponentiation by squaring.

Returns a tuple of the exponentiation along with a bool indicating whether an overflow happened.

# Examples

Basic usage:

```#![feature(no_panic_pow)]
assert_eq!(3i128.overflowing_pow(4), (81, false));
assert_eq!(3i8.overflowing_pow(5), (-13, true));Run```

#### `pub fn pow(self, exp: u32) -> i128`1.0.0[src]

Raises self to the power of `exp`, using exponentiation by squaring.

# Examples

Basic usage:

```let x: i128 = 2; // or any other integer type

assert_eq!(x.pow(5), 32);Run```

#### `pub fn div_euc(self, rhs: i128) -> i128`[src]

🔬 This is a nightly-only experimental API. (`euclidean_division `#49048)

Calculates the quotient of Euclidean division of `self` by `rhs`.

This computes the integer `n` such that `self = n * rhs + self.mod_euc(rhs)`. In other words, the result is `self / rhs` rounded to the integer `n` such that `self >= n * rhs`.

# Panics

This function will panic if `rhs` is 0.

# Examples

Basic usage:

```#![feature(euclidean_division)]
let a: i128 = 7; // or any other integer type
let b = 4;

assert_eq!(a.div_euc(b), 1); // 7 >= 4 * 1
assert_eq!(a.div_euc(-b), -1); // 7 >= -4 * -1
assert_eq!((-a).div_euc(b), -2); // -7 >= 4 * -2
assert_eq!((-a).div_euc(-b), 2); // -7 >= -4 * 2Run```

#### `pub fn mod_euc(self, rhs: i128) -> i128`[src]

🔬 This is a nightly-only experimental API. (`euclidean_division `#49048)

Calculates the remainder `self mod rhs` by Euclidean division.

In particular, the result `n` satisfies `0 <= n < rhs.abs()`.

# Panics

This function will panic if `rhs` is 0.

# Examples

Basic usage:

```#![feature(euclidean_division)]
let a: i128 = 7; // or any other integer type
let b = 4;

assert_eq!(a.mod_euc(b), 3);
assert_eq!((-a).mod_euc(b), 1);
assert_eq!(a.mod_euc(-b), 3);
assert_eq!((-a).mod_euc(-b), 1);Run```

#### `pub fn abs(self) -> i128`1.0.0[src]

Computes the absolute value of `self`.

# Overflow behavior

The absolute value of `i128::min_value()` cannot be represented as an `i128`, and attempting to calculate it will cause an overflow. This means that code in debug mode will trigger a panic on this case and optimized code will return `i128::min_value()` without a panic.

# Examples

Basic usage:

```assert_eq!(10i128.abs(), 10);
assert_eq!((-10i128).abs(), 10);Run```

#### `pub fn signum(self) -> i128`1.0.0[src]

Returns a number representing sign of `self`.

• `0` if the number is zero
• `1` if the number is positive
• `-1` if the number is negative

# Examples

Basic usage:

```assert_eq!(10i128.signum(), 1);
assert_eq!(0i128.signum(), 0);
assert_eq!((-10i128).signum(), -1);Run```

#### `pub const fn is_positive(self) -> bool`1.0.0[src]

Returns `true` if `self` is positive and `false` if the number is zero or negative.

# Examples

Basic usage:

```assert!(10i128.is_positive());
assert!(!(-10i128).is_positive());Run```

#### `pub const fn is_negative(self) -> bool`1.0.0[src]

Returns `true` if `self` is negative and `false` if the number is zero or positive.

# Examples

Basic usage:

```assert!((-10i128).is_negative());
assert!(!10i128.is_negative());Run```

#### `pub const fn to_be_bytes(self) -> [u8; 16]`[src]

🔬 This is a nightly-only experimental API. (`int_to_from_bytes `#52963)

Return the memory representation of this integer as a byte array in big-endian (network) byte order.

# Examples

```#![feature(int_to_from_bytes)]

let bytes = 0x12345678901234567890123456789012i128.to_be_bytes();
assert_eq!(bytes, [0x12, 0x34, 0x56, 0x78, 0x90, 0x12, 0x34, 0x56, 0x78, 0x90, 0x12, 0x34, 0x56, 0x78, 0x90, 0x12]);Run```

#### `pub const fn to_le_bytes(self) -> [u8; 16]`[src]

🔬 This is a nightly-only experimental API. (`int_to_from_bytes `#52963)

Return the memory representation of this integer as a byte array in little-endian byte order.

# Examples

```#![feature(int_to_from_bytes)]

let bytes = 0x12345678901234567890123456789012i128.to_le_bytes();
assert_eq!(bytes, [0x12, 0x90, 0x78, 0x56, 0x34, 0x12, 0x90, 0x78, 0x56, 0x34, 0x12, 0x90, 0x78, 0x56, 0x34, 0x12]);Run```

#### `pub const fn to_ne_bytes(self) -> [u8; 16]`[src]

🔬 This is a nightly-only experimental API. (`int_to_from_bytes `#52963)

Return the memory representation of this integer as a byte array in native byte order.

As the target platform's native endianness is used, portable code should use `to_be_bytes` or `to_le_bytes`, as appropriate, instead.

# Examples

```#![feature(int_to_from_bytes)]

let bytes = 0x12345678901234567890123456789012i128.to_ne_bytes();
assert_eq!(bytes, if cfg!(target_endian = "big") {
[0x12, 0x34, 0x56, 0x78, 0x90, 0x12, 0x34, 0x56, 0x78, 0x90, 0x12, 0x34, 0x56, 0x78, 0x90, 0x12]
} else {
[0x12, 0x90, 0x78, 0x56, 0x34, 0x12, 0x90, 0x78, 0x56, 0x34, 0x12, 0x90, 0x78, 0x56, 0x34, 0x12]
});Run```

#### `pub const fn from_be_bytes(bytes: [u8; 16]) -> i128`[src]

🔬 This is a nightly-only experimental API. (`int_to_from_bytes `#52963)

Create an integer value from its representation as a byte array in big endian.

# Examples

```#![feature(int_to_from_bytes)]

let value = i128::from_be_bytes([0x12, 0x34, 0x56, 0x78, 0x90, 0x12, 0x34, 0x56, 0x78, 0x90, 0x12, 0x34, 0x56, 0x78, 0x90, 0x12]);
assert_eq!(value, 0x12345678901234567890123456789012);Run```

#### `pub const fn from_le_bytes(bytes: [u8; 16]) -> i128`[src]

🔬 This is a nightly-only experimental API. (`int_to_from_bytes `#52963)

Create an integer value from its representation as a byte array in little endian.

# Examples

```#![feature(int_to_from_bytes)]

let value = i128::from_le_bytes([0x12, 0x90, 0x78, 0x56, 0x34, 0x12, 0x90, 0x78, 0x56, 0x34, 0x12, 0x90, 0x78, 0x56, 0x34, 0x12]);
assert_eq!(value, 0x12345678901234567890123456789012);Run```

#### `pub const fn from_ne_bytes(bytes: [u8; 16]) -> i128`[src]

🔬 This is a nightly-only experimental API. (`int_to_from_bytes `#52963)

Create an integer value from its memory representation as a byte array in native endianness.

As the target platform's native endianness is used, portable code likely wants to use `from_be_bytes` or `from_le_bytes`, as appropriate instead.

# Examples

```#![feature(int_to_from_bytes)]

let value = i128::from_ne_bytes(if cfg!(target_endian = "big") {
[0x12, 0x34, 0x56, 0x78, 0x90, 0x12, 0x34, 0x56, 0x78, 0x90, 0x12, 0x34, 0x56, 0x78, 0x90, 0x12]
} else {
[0x12, 0x90, 0x78, 0x56, 0x34, 0x12, 0x90, 0x78, 0x56, 0x34, 0x12, 0x90, 0x78, 0x56, 0x34, 0x12]
});
assert_eq!(value, 0x12345678901234567890123456789012);Run```

## Trait Implementations

### `impl TryFrom<usize> for i128`[src]

#### `type Error = TryFromIntError`

🔬 This is a nightly-only experimental API. (`try_from `#33417)

The type returned in the event of a conversion error.

#### `fn try_from(value: usize) -> Result<i128, <i128 as TryFrom<usize>>::Error>`[src]

🔬 This is a nightly-only experimental API. (`try_from `#33417)

Performs the conversion.

### `impl TryFrom<u128> for i128`[src]

#### `type Error = TryFromIntError`

🔬 This is a nightly-only experimental API. (`try_from `#33417)

The type returned in the event of a conversion error.

#### `fn try_from(u: u128) -> Result<i128, TryFromIntError>`[src]

🔬 This is a nightly-only experimental API. (`try_from `#33417)

Performs the conversion.

### `impl TryFrom<isize> for i128`[src]

#### `type Error = TryFromIntError`

🔬 This is a nightly-only experimental API. (`try_from `#33417)

The type returned in the event of a conversion error.

#### `fn try_from(value: isize) -> Result<i128, <i128 as TryFrom<isize>>::Error>`[src]

🔬 This is a nightly-only experimental API. (`try_from `#33417)

Performs the conversion.

### `impl<'a> RemAssign<&'a i128> for i128`1.22.0[src]

#### `fn rem_assign(&mut self, other: &'a i128)`[src]

Performs the `%=` operation.

### `impl RemAssign<i128> for i128`1.8.0[src]

#### `fn rem_assign(&mut self, other: i128)`[src]

Performs the `%=` operation.

### `impl FromStr for i128`1.0.0[src]

#### `type Err = ParseIntError`

The associated error which can be returned from parsing.

#### `fn from_str(src: &str) -> Result<i128, ParseIntError>`[src]

Parses a string `s` to return a value of this type. Read more

### `impl DivAssign<i128> for i128`1.8.0[src]

#### `fn div_assign(&mut self, other: i128)`[src]

Performs the `/=` operation.

### `impl<'a> DivAssign<&'a i128> for i128`1.22.0[src]

#### `fn div_assign(&mut self, other: &'a i128)`[src]

Performs the `/=` operation.

### `impl MulAssign<i128> for i128`1.8.0[src]

#### `fn mul_assign(&mut self, other: i128)`[src]

Performs the `*=` operation.

### `impl<'a> MulAssign<&'a i128> for i128`1.22.0[src]

#### `fn mul_assign(&mut self, other: &'a i128)`[src]

Performs the `*=` operation.

### `impl SubAssign<i128> for i128`1.8.0[src]

#### `fn sub_assign(&mut self, other: i128)`[src]

Performs the `-=` operation.

### `impl<'a> SubAssign<&'a i128> for i128`1.22.0[src]

#### `fn sub_assign(&mut self, other: &'a i128)`[src]

Performs the `-=` operation.

### `impl Hash for i128`1.0.0[src]

#### `fn hash<H>(&self, state: &mut H) where    H: Hasher, `[src]

Feeds this value into the given [`Hasher`]. Read more

#### `fn hash_slice<H>(data: &[i128], state: &mut H) where    H: Hasher, `[src]

Feeds a slice of this type into the given [`Hasher`]. Read more

### `impl AddAssign<i128> for i128`1.8.0[src]

#### `fn add_assign(&mut self, other: i128)`[src]

Performs the `+=` operation.

### `impl<'a> AddAssign<&'a i128> for i128`1.22.0[src]

#### `fn add_assign(&mut self, other: &'a i128)`[src]

Performs the `+=` operation.

### `impl<'a> Neg for &'a i128`1.0.0[src]

#### `type Output = <i128 as Neg>::Output`

The resulting type after applying the `-` operator.

#### `fn neg(self) -> <i128 as Neg>::Output`[src]

Performs the unary `-` operation.

### `impl Neg for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `-` operator.

#### `fn neg(self) -> i128`[src]

Performs the unary `-` operation.

### `impl ShrAssign<i64> for i128`1.8.0[src]

#### `fn shr_assign(&mut self, other: i64)`[src]

Performs the `>>=` operation.

### `impl ShrAssign<usize> for i128`1.8.0[src]

#### `fn shr_assign(&mut self, other: usize)`[src]

Performs the `>>=` operation.

### `impl<'a> ShrAssign<&'a usize> for i128`1.22.0[src]

#### `fn shr_assign(&mut self, other: &'a usize)`[src]

Performs the `>>=` operation.

### `impl<'a> ShrAssign<&'a u128> for i128`1.22.0[src]

#### `fn shr_assign(&mut self, other: &'a u128)`[src]

Performs the `>>=` operation.

### `impl<'a> ShrAssign<&'a i64> for i128`1.22.0[src]

#### `fn shr_assign(&mut self, other: &'a i64)`[src]

Performs the `>>=` operation.

### `impl<'a> ShrAssign<&'a isize> for i128`1.22.0[src]

#### `fn shr_assign(&mut self, other: &'a isize)`[src]

Performs the `>>=` operation.

### `impl ShrAssign<u32> for i128`1.8.0[src]

#### `fn shr_assign(&mut self, other: u32)`[src]

Performs the `>>=` operation.

### `impl<'a> ShrAssign<&'a u8> for i128`1.22.0[src]

#### `fn shr_assign(&mut self, other: &'a u8)`[src]

Performs the `>>=` operation.

### `impl ShrAssign<u16> for i128`1.8.0[src]

#### `fn shr_assign(&mut self, other: u16)`[src]

Performs the `>>=` operation.

### `impl ShrAssign<i32> for i128`1.8.0[src]

#### `fn shr_assign(&mut self, other: i32)`[src]

Performs the `>>=` operation.

### `impl ShrAssign<isize> for i128`1.8.0[src]

#### `fn shr_assign(&mut self, other: isize)`[src]

Performs the `>>=` operation.

### `impl<'a> ShrAssign<&'a u32> for i128`1.22.0[src]

#### `fn shr_assign(&mut self, other: &'a u32)`[src]

Performs the `>>=` operation.

### `impl ShrAssign<u128> for i128`1.8.0[src]

#### `fn shr_assign(&mut self, other: u128)`[src]

Performs the `>>=` operation.

### `impl<'a> ShrAssign<&'a i8> for i128`1.22.0[src]

#### `fn shr_assign(&mut self, other: &'a i8)`[src]

Performs the `>>=` operation.

### `impl<'a> ShrAssign<&'a i16> for i128`1.22.0[src]

#### `fn shr_assign(&mut self, other: &'a i16)`[src]

Performs the `>>=` operation.

### `impl ShrAssign<i128> for i128`1.8.0[src]

#### `fn shr_assign(&mut self, other: i128)`[src]

Performs the `>>=` operation.

### `impl<'a> ShrAssign<&'a u16> for i128`1.22.0[src]

#### `fn shr_assign(&mut self, other: &'a u16)`[src]

Performs the `>>=` operation.

### `impl ShrAssign<i8> for i128`1.8.0[src]

#### `fn shr_assign(&mut self, other: i8)`[src]

Performs the `>>=` operation.

### `impl ShrAssign<i16> for i128`1.8.0[src]

#### `fn shr_assign(&mut self, other: i16)`[src]

Performs the `>>=` operation.

### `impl ShrAssign<u8> for i128`1.8.0[src]

#### `fn shr_assign(&mut self, other: u8)`[src]

Performs the `>>=` operation.

### `impl<'a> ShrAssign<&'a i32> for i128`1.22.0[src]

#### `fn shr_assign(&mut self, other: &'a i32)`[src]

Performs the `>>=` operation.

### `impl<'a> ShrAssign<&'a u64> for i128`1.22.0[src]

#### `fn shr_assign(&mut self, other: &'a u64)`[src]

Performs the `>>=` operation.

### `impl<'a> ShrAssign<&'a i128> for i128`1.22.0[src]

#### `fn shr_assign(&mut self, other: &'a i128)`[src]

Performs the `>>=` operation.

### `impl ShrAssign<u64> for i128`1.8.0[src]

#### `fn shr_assign(&mut self, other: u64)`[src]

Performs the `>>=` operation.

### `impl Clone for i128`1.0.0[src]

#### `fn clone(&self) -> i128`[src]

Returns a copy of the value. Read more

#### `fn clone_from(&mut self, source: &Self)`1.0.0[src]

Performs copy-assignment from `source`. Read more

### `impl PartialOrd<i128> for i128`1.0.0[src]

#### `fn partial_cmp(&self, other: &i128) -> Option<Ordering>`[src]

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

#### `fn lt(&self, other: &i128) -> bool`[src]

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

#### `fn le(&self, other: &i128) -> bool`[src]

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

#### `fn ge(&self, other: &i128) -> bool`[src]

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

#### `fn gt(&self, other: &i128) -> bool`[src]

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

### `impl Ord for i128`1.0.0[src]

#### `fn cmp(&self, other: &i128) -> Ordering`[src]

This method returns an `Ordering` between `self` and `other`. Read more

#### `fn max(self, other: Self) -> Self`1.21.0[src]

Compares and returns the maximum of two values. Read more

#### `fn min(self, other: Self) -> Self`1.21.0[src]

Compares and returns the minimum of two values. Read more

### `impl Sub<i128> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `-` operator.

#### `fn sub(self, other: i128) -> i128`[src]

Performs the `-` operation.

### `impl<'a> Sub<i128> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Sub<i128>>::Output`

The resulting type after applying the `-` operator.

#### `fn sub(self, other: i128) -> <i128 as Sub<i128>>::Output`[src]

Performs the `-` operation.

### `impl<'a, 'b> Sub<&'a i128> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Sub<i128>>::Output`

The resulting type after applying the `-` operator.

#### `fn sub(self, other: &'a i128) -> <i128 as Sub<i128>>::Output`[src]

Performs the `-` operation.

### `impl<'a> Sub<&'a i128> for i128`1.0.0[src]

#### `type Output = <i128 as Sub<i128>>::Output`

The resulting type after applying the `-` operator.

#### `fn sub(self, other: &'a i128) -> <i128 as Sub<i128>>::Output`[src]

Performs the `-` operation.

### `impl<'a> Shr<usize> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Shr<usize>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: usize) -> <i128 as Shr<usize>>::Output`[src]

Performs the `>>` operation.

### `impl Shr<u64> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: u64) -> i128`[src]

Performs the `>>` operation.

### `impl<'a> Shr<u16> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Shr<u16>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: u16) -> <i128 as Shr<u16>>::Output`[src]

Performs the `>>` operation.

### `impl<'a> Shr<i8> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Shr<i8>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: i8) -> <i128 as Shr<i8>>::Output`[src]

Performs the `>>` operation.

### `impl<'a> Shr<&'a i32> for i128`1.0.0[src]

#### `type Output = <i128 as Shr<i32>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: &'a i32) -> <i128 as Shr<i32>>::Output`[src]

Performs the `>>` operation.

### `impl<'a> Shr<&'a u64> for i128`1.0.0[src]

#### `type Output = <i128 as Shr<u64>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: &'a u64) -> <i128 as Shr<u64>>::Output`[src]

Performs the `>>` operation.

### `impl<'a> Shr<&'a u32> for i128`1.0.0[src]

#### `type Output = <i128 as Shr<u32>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: &'a u32) -> <i128 as Shr<u32>>::Output`[src]

Performs the `>>` operation.

### `impl<'a> Shr<u64> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Shr<u64>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: u64) -> <i128 as Shr<u64>>::Output`[src]

Performs the `>>` operation.

### `impl<'a, 'b> Shr<&'a i64> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Shr<i64>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: &'a i64) -> <i128 as Shr<i64>>::Output`[src]

Performs the `>>` operation.

### `impl Shr<i32> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: i32) -> i128`[src]

Performs the `>>` operation.

### `impl<'a> Shr<&'a i64> for i128`1.0.0[src]

#### `type Output = <i128 as Shr<i64>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: &'a i64) -> <i128 as Shr<i64>>::Output`[src]

Performs the `>>` operation.

### `impl<'a, 'b> Shr<&'a u128> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Shr<u128>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: &'a u128) -> <i128 as Shr<u128>>::Output`[src]

Performs the `>>` operation.

### `impl Shr<i64> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: i64) -> i128`[src]

Performs the `>>` operation.

### `impl<'a> Shr<&'a usize> for i128`1.0.0[src]

#### `type Output = <i128 as Shr<usize>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: &'a usize) -> <i128 as Shr<usize>>::Output`[src]

Performs the `>>` operation.

### `impl<'a> Shr<u128> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Shr<u128>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: u128) -> <i128 as Shr<u128>>::Output`[src]

Performs the `>>` operation.

### `impl Shr<i16> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: i16) -> i128`[src]

Performs the `>>` operation.

### `impl Shr<u8> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: u8) -> i128`[src]

Performs the `>>` operation.

### `impl<'a, 'b> Shr<&'a usize> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Shr<usize>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: &'a usize) -> <i128 as Shr<usize>>::Output`[src]

Performs the `>>` operation.

### `impl<'a, 'b> Shr<&'a i8> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Shr<i8>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: &'a i8) -> <i128 as Shr<i8>>::Output`[src]

Performs the `>>` operation.

### `impl<'a> Shr<&'a u128> for i128`1.0.0[src]

#### `type Output = <i128 as Shr<u128>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: &'a u128) -> <i128 as Shr<u128>>::Output`[src]

Performs the `>>` operation.

### `impl Shr<i128> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: i128) -> i128`[src]

Performs the `>>` operation.

### `impl Shr<u16> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: u16) -> i128`[src]

Performs the `>>` operation.

### `impl<'a, 'b> Shr<&'a isize> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Shr<isize>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: &'a isize) -> <i128 as Shr<isize>>::Output`[src]

Performs the `>>` operation.

### `impl<'a> Shr<i16> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Shr<i16>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: i16) -> <i128 as Shr<i16>>::Output`[src]

Performs the `>>` operation.

### `impl Shr<u32> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: u32) -> i128`[src]

Performs the `>>` operation.

### `impl<'a, 'b> Shr<&'a u64> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Shr<u64>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: &'a u64) -> <i128 as Shr<u64>>::Output`[src]

Performs the `>>` operation.

### `impl<'a, 'b> Shr<&'a u8> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Shr<u8>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: &'a u8) -> <i128 as Shr<u8>>::Output`[src]

Performs the `>>` operation.

### `impl<'a> Shr<i64> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Shr<i64>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: i64) -> <i128 as Shr<i64>>::Output`[src]

Performs the `>>` operation.

### `impl Shr<i8> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: i8) -> i128`[src]

Performs the `>>` operation.

### `impl<'a> Shr<&'a i8> for i128`1.0.0[src]

#### `type Output = <i128 as Shr<i8>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: &'a i8) -> <i128 as Shr<i8>>::Output`[src]

Performs the `>>` operation.

### `impl<'a, 'b> Shr<&'a i32> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Shr<i32>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: &'a i32) -> <i128 as Shr<i32>>::Output`[src]

Performs the `>>` operation.

### `impl<'a, 'b> Shr<&'a i16> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Shr<i16>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: &'a i16) -> <i128 as Shr<i16>>::Output`[src]

Performs the `>>` operation.

### `impl<'a> Shr<u8> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Shr<u8>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: u8) -> <i128 as Shr<u8>>::Output`[src]

Performs the `>>` operation.

### `impl<'a, 'b> Shr<&'a u32> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Shr<u32>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: &'a u32) -> <i128 as Shr<u32>>::Output`[src]

Performs the `>>` operation.

### `impl Shr<isize> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: isize) -> i128`[src]

Performs the `>>` operation.

### `impl<'a> Shr<i128> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Shr<i128>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: i128) -> <i128 as Shr<i128>>::Output`[src]

Performs the `>>` operation.

### `impl<'a> Shr<&'a u16> for i128`1.0.0[src]

#### `type Output = <i128 as Shr<u16>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: &'a u16) -> <i128 as Shr<u16>>::Output`[src]

Performs the `>>` operation.

### `impl<'a> Shr<isize> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Shr<isize>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: isize) -> <i128 as Shr<isize>>::Output`[src]

Performs the `>>` operation.

### `impl<'a> Shr<&'a i16> for i128`1.0.0[src]

#### `type Output = <i128 as Shr<i16>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: &'a i16) -> <i128 as Shr<i16>>::Output`[src]

Performs the `>>` operation.

### `impl<'a> Shr<i32> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Shr<i32>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: i32) -> <i128 as Shr<i32>>::Output`[src]

Performs the `>>` operation.

### `impl Shr<u128> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: u128) -> i128`[src]

Performs the `>>` operation.

### `impl<'a, 'b> Shr<&'a u16> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Shr<u16>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: &'a u16) -> <i128 as Shr<u16>>::Output`[src]

Performs the `>>` operation.

### `impl<'a> Shr<&'a isize> for i128`1.0.0[src]

#### `type Output = <i128 as Shr<isize>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: &'a isize) -> <i128 as Shr<isize>>::Output`[src]

Performs the `>>` operation.

### `impl<'a, 'b> Shr<&'a i128> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Shr<i128>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: &'a i128) -> <i128 as Shr<i128>>::Output`[src]

Performs the `>>` operation.

### `impl<'a> Shr<&'a i128> for i128`1.0.0[src]

#### `type Output = <i128 as Shr<i128>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: &'a i128) -> <i128 as Shr<i128>>::Output`[src]

Performs the `>>` operation.

### `impl<'a> Shr<&'a u8> for i128`1.0.0[src]

#### `type Output = <i128 as Shr<u8>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: &'a u8) -> <i128 as Shr<u8>>::Output`[src]

Performs the `>>` operation.

### `impl Shr<usize> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: usize) -> i128`[src]

Performs the `>>` operation.

### `impl<'a> Shr<u32> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Shr<u32>>::Output`

The resulting type after applying the `>>` operator.

#### `fn shr(self, other: u32) -> <i128 as Shr<u32>>::Output`[src]

Performs the `>>` operation.

### `impl Binary for i128`1.0.0[src]

#### `fn fmt(&self, f: &mut Formatter) -> Result<(), Error>`[src]

Formats the value using the given formatter.

### `impl Sum<i128> for i128`1.12.0[src]

#### `fn sum<I>(iter: I) -> i128 where    I: Iterator<Item = i128>, `[src]

Method which takes an iterator and generates `Self` from the elements by "summing up" the items. Read more

### `impl<'a> Sum<&'a i128> for i128`1.12.0[src]

#### `fn sum<I>(iter: I) -> i128 where    I: Iterator<Item = &'a i128>, `[src]

Method which takes an iterator and generates `Self` from the elements by "summing up" the items. Read more

### `impl<'a> BitXor<i128> for &'a i128`1.0.0[src]

#### `type Output = <i128 as BitXor<i128>>::Output`

The resulting type after applying the `^` operator.

#### `fn bitxor(self, other: i128) -> <i128 as BitXor<i128>>::Output`[src]

Performs the `^` operation.

### `impl<'a> BitXor<&'a i128> for i128`1.0.0[src]

#### `type Output = <i128 as BitXor<i128>>::Output`

The resulting type after applying the `^` operator.

#### `fn bitxor(self, other: &'a i128) -> <i128 as BitXor<i128>>::Output`[src]

Performs the `^` operation.

### `impl<'a, 'b> BitXor<&'a i128> for &'b i128`1.0.0[src]

#### `type Output = <i128 as BitXor<i128>>::Output`

The resulting type after applying the `^` operator.

#### `fn bitxor(self, other: &'a i128) -> <i128 as BitXor<i128>>::Output`[src]

Performs the `^` operation.

### `impl BitXor<i128> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `^` operator.

#### `fn bitxor(self, other: i128) -> i128`[src]

Performs the `^` operation.

### `impl Debug for i128`1.0.0[src]

#### `fn fmt(&self, f: &mut Formatter) -> Result<(), Error>`[src]

Formats the value using the given formatter. Read more

### `impl Step for i128`[src]

#### `fn steps_between(_start: &i128, _end: &i128) -> Option<usize>`[src]

🔬 This is a nightly-only experimental API. (`step_trait `#42168)

likely to be replaced by finer-grained traits

Returns the number of steps between two step objects. The count is inclusive of `start` and exclusive of `end`. Read more

#### `fn add_usize(&self, n: usize) -> Option<i128>`[src]

🔬 This is a nightly-only experimental API. (`step_trait `#42168)

likely to be replaced by finer-grained traits

Add an usize, returning None on overflow

#### `fn replace_one(&mut self) -> i128`[src]

🔬 This is a nightly-only experimental API. (`step_trait `#42168)

likely to be replaced by finer-grained traits

Replaces this step with `1`, returning itself

#### `fn replace_zero(&mut self) -> i128`[src]

🔬 This is a nightly-only experimental API. (`step_trait `#42168)

likely to be replaced by finer-grained traits

Replaces this step with `0`, returning itself

#### `fn add_one(&self) -> i128`[src]

🔬 This is a nightly-only experimental API. (`step_trait `#42168)

likely to be replaced by finer-grained traits

Adds one to this step, returning the result

#### `fn sub_one(&self) -> i128`[src]

🔬 This is a nightly-only experimental API. (`step_trait `#42168)

likely to be replaced by finer-grained traits

Subtracts one to this step, returning the result

### `impl PartialEq<i128> for i128`1.0.0[src]

#### `fn eq(&self, other: &i128) -> bool`[src]

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

#### `fn ne(&self, other: &i128) -> bool`[src]

This method tests for `!=`.

### `impl Not for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `!` operator.

#### `fn not(self) -> i128`[src]

Performs the unary `!` operation.

### `impl<'a> Not for &'a i128`1.0.0[src]

#### `type Output = <i128 as Not>::Output`

The resulting type after applying the `!` operator.

#### `fn not(self) -> <i128 as Not>::Output`[src]

Performs the unary `!` operation.

### `impl From<bool> for i128`1.28.0[src]

Converts a `bool` to a `i128`. The resulting value is `0` for `false` and `1` for `true` values.

# Examples

```assert_eq!(i128::from(true), 1);
assert_eq!(i128::from(false), 0);Run```

#### `fn from(small: bool) -> i128`[src]

Performs the conversion.

### `impl From<u16> for i128`[src]

Converts `u16` to `i128` losslessly.

#### `fn from(small: u16) -> i128`[src]

Performs the conversion.

### `impl From<i16> for i128`[src]

Converts `i16` to `i128` losslessly.

#### `fn from(small: i16) -> i128`[src]

Performs the conversion.

### `impl From<u64> for i128`[src]

Converts `u64` to `i128` losslessly.

#### `fn from(small: u64) -> i128`[src]

Performs the conversion.

### `impl From<i32> for i128`[src]

Converts `i32` to `i128` losslessly.

#### `fn from(small: i32) -> i128`[src]

Performs the conversion.

### `impl From<u8> for i128`[src]

Converts `u8` to `i128` losslessly.

#### `fn from(small: u8) -> i128`[src]

Performs the conversion.

### `impl From<i8> for i128`[src]

Converts `i8` to `i128` losslessly.

#### `fn from(small: i8) -> i128`[src]

Performs the conversion.

### `impl From<u32> for i128`[src]

Converts `u32` to `i128` losslessly.

#### `fn from(small: u32) -> i128`[src]

Performs the conversion.

### `impl From<i64> for i128`[src]

Converts `i64` to `i128` losslessly.

#### `fn from(small: i64) -> i128`[src]

Performs the conversion.

### `impl<'a> Rem<&'a i128> for i128`1.0.0[src]

#### `type Output = <i128 as Rem<i128>>::Output`

The resulting type after applying the `%` operator.

#### `fn rem(self, other: &'a i128) -> <i128 as Rem<i128>>::Output`[src]

Performs the `%` operation.

### `impl Rem<i128> for i128`1.0.0[src]

This operation satisfies `n % d == n - (n / d) * d`. The result has the same sign as the left operand.

#### `type Output = i128`

The resulting type after applying the `%` operator.

#### `fn rem(self, other: i128) -> i128`[src]

Performs the `%` operation.

### `impl<'a> Rem<i128> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Rem<i128>>::Output`

The resulting type after applying the `%` operator.

#### `fn rem(self, other: i128) -> <i128 as Rem<i128>>::Output`[src]

Performs the `%` operation.

### `impl<'a, 'b> Rem<&'a i128> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Rem<i128>>::Output`

The resulting type after applying the `%` operator.

#### `fn rem(self, other: &'a i128) -> <i128 as Rem<i128>>::Output`[src]

Performs the `%` operation.

### `impl<'a> Mul<i128> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Mul<i128>>::Output`

The resulting type after applying the `*` operator.

#### `fn mul(self, other: i128) -> <i128 as Mul<i128>>::Output`[src]

Performs the `*` operation.

### `impl<'a> Mul<&'a i128> for i128`1.0.0[src]

#### `type Output = <i128 as Mul<i128>>::Output`

The resulting type after applying the `*` operator.

#### `fn mul(self, other: &'a i128) -> <i128 as Mul<i128>>::Output`[src]

Performs the `*` operation.

### `impl Mul<i128> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `*` operator.

#### `fn mul(self, other: i128) -> i128`[src]

Performs the `*` operation.

### `impl<'a, 'b> Mul<&'a i128> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Mul<i128>>::Output`

The resulting type after applying the `*` operator.

#### `fn mul(self, other: &'a i128) -> <i128 as Mul<i128>>::Output`[src]

Performs the `*` operation.

### `impl UpperHex for i128`1.0.0[src]

#### `fn fmt(&self, f: &mut Formatter) -> Result<(), Error>`[src]

Formats the value using the given formatter.

### `impl Octal for i128`1.0.0[src]

#### `fn fmt(&self, f: &mut Formatter) -> Result<(), Error>`[src]

Formats the value using the given formatter.

### `impl<'a> Shl<&'a i128> for i128`1.0.0[src]

#### `type Output = <i128 as Shl<i128>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: &'a i128) -> <i128 as Shl<i128>>::Output`[src]

Performs the `<<` operation.

### `impl<'a> Shl<&'a u64> for i128`1.0.0[src]

#### `type Output = <i128 as Shl<u64>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: &'a u64) -> <i128 as Shl<u64>>::Output`[src]

Performs the `<<` operation.

### `impl<'a, 'b> Shl<&'a i128> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Shl<i128>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: &'a i128) -> <i128 as Shl<i128>>::Output`[src]

Performs the `<<` operation.

### `impl Shl<u128> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: u128) -> i128`[src]

Performs the `<<` operation.

### `impl Shl<u64> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: u64) -> i128`[src]

Performs the `<<` operation.

### `impl<'a> Shl<i8> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Shl<i8>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: i8) -> <i128 as Shl<i8>>::Output`[src]

Performs the `<<` operation.

### `impl<'a> Shl<i64> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Shl<i64>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: i64) -> <i128 as Shl<i64>>::Output`[src]

Performs the `<<` operation.

### `impl<'a> Shl<u16> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Shl<u16>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: u16) -> <i128 as Shl<u16>>::Output`[src]

Performs the `<<` operation.

### `impl<'a> Shl<&'a i64> for i128`1.0.0[src]

#### `type Output = <i128 as Shl<i64>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: &'a i64) -> <i128 as Shl<i64>>::Output`[src]

Performs the `<<` operation.

### `impl<'a> Shl<&'a u128> for i128`1.0.0[src]

#### `type Output = <i128 as Shl<u128>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: &'a u128) -> <i128 as Shl<u128>>::Output`[src]

Performs the `<<` operation.

### `impl<'a, 'b> Shl<&'a i32> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Shl<i32>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: &'a i32) -> <i128 as Shl<i32>>::Output`[src]

Performs the `<<` operation.

### `impl<'a> Shl<&'a i16> for i128`1.0.0[src]

#### `type Output = <i128 as Shl<i16>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: &'a i16) -> <i128 as Shl<i16>>::Output`[src]

Performs the `<<` operation.

### `impl Shl<u16> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: u16) -> i128`[src]

Performs the `<<` operation.

### `impl<'a, 'b> Shl<&'a i64> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Shl<i64>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: &'a i64) -> <i128 as Shl<i64>>::Output`[src]

Performs the `<<` operation.

### `impl<'a, 'b> Shl<&'a u8> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Shl<u8>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: &'a u8) -> <i128 as Shl<u8>>::Output`[src]

Performs the `<<` operation.

### `impl<'a> Shl<i32> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Shl<i32>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: i32) -> <i128 as Shl<i32>>::Output`[src]

Performs the `<<` operation.

### `impl<'a> Shl<&'a u16> for i128`1.0.0[src]

#### `type Output = <i128 as Shl<u16>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: &'a u16) -> <i128 as Shl<u16>>::Output`[src]

Performs the `<<` operation.

### `impl Shl<u8> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: u8) -> i128`[src]

Performs the `<<` operation.

### `impl<'a> Shl<&'a usize> for i128`1.0.0[src]

#### `type Output = <i128 as Shl<usize>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: &'a usize) -> <i128 as Shl<usize>>::Output`[src]

Performs the `<<` operation.

### `impl<'a> Shl<&'a i32> for i128`1.0.0[src]

#### `type Output = <i128 as Shl<i32>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: &'a i32) -> <i128 as Shl<i32>>::Output`[src]

Performs the `<<` operation.

### `impl<'a> Shl<i16> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Shl<i16>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: i16) -> <i128 as Shl<i16>>::Output`[src]

Performs the `<<` operation.

### `impl<'a, 'b> Shl<&'a usize> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Shl<usize>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: &'a usize) -> <i128 as Shl<usize>>::Output`[src]

Performs the `<<` operation.

### `impl Shl<i32> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: i32) -> i128`[src]

Performs the `<<` operation.

### `impl<'a, 'b> Shl<&'a u64> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Shl<u64>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: &'a u64) -> <i128 as Shl<u64>>::Output`[src]

Performs the `<<` operation.

### `impl<'a> Shl<u8> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Shl<u8>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: u8) -> <i128 as Shl<u8>>::Output`[src]

Performs the `<<` operation.

### `impl<'a, 'b> Shl<&'a u32> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Shl<u32>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: &'a u32) -> <i128 as Shl<u32>>::Output`[src]

Performs the `<<` operation.

### `impl Shl<isize> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: isize) -> i128`[src]

Performs the `<<` operation.

### `impl<'a> Shl<&'a u8> for i128`1.0.0[src]

#### `type Output = <i128 as Shl<u8>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: &'a u8) -> <i128 as Shl<u8>>::Output`[src]

Performs the `<<` operation.

### `impl<'a> Shl<u32> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Shl<u32>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: u32) -> <i128 as Shl<u32>>::Output`[src]

Performs the `<<` operation.

### `impl<'a> Shl<isize> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Shl<isize>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: isize) -> <i128 as Shl<isize>>::Output`[src]

Performs the `<<` operation.

### `impl<'a, 'b> Shl<&'a isize> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Shl<isize>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: &'a isize) -> <i128 as Shl<isize>>::Output`[src]

Performs the `<<` operation.

### `impl<'a, 'b> Shl<&'a i8> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Shl<i8>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: &'a i8) -> <i128 as Shl<i8>>::Output`[src]

Performs the `<<` operation.

### `impl<'a> Shl<usize> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Shl<usize>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: usize) -> <i128 as Shl<usize>>::Output`[src]

Performs the `<<` operation.

### `impl<'a> Shl<&'a i8> for i128`1.0.0[src]

#### `type Output = <i128 as Shl<i8>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: &'a i8) -> <i128 as Shl<i8>>::Output`[src]

Performs the `<<` operation.

### `impl Shl<usize> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: usize) -> i128`[src]

Performs the `<<` operation.

### `impl Shl<i64> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: i64) -> i128`[src]

Performs the `<<` operation.

### `impl<'a, 'b> Shl<&'a u16> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Shl<u16>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: &'a u16) -> <i128 as Shl<u16>>::Output`[src]

Performs the `<<` operation.

### `impl<'a> Shl<i128> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Shl<i128>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: i128) -> <i128 as Shl<i128>>::Output`[src]

Performs the `<<` operation.

### `impl<'a, 'b> Shl<&'a u128> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Shl<u128>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: &'a u128) -> <i128 as Shl<u128>>::Output`[src]

Performs the `<<` operation.

### `impl<'a, 'b> Shl<&'a i16> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Shl<i16>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: &'a i16) -> <i128 as Shl<i16>>::Output`[src]

Performs the `<<` operation.

### `impl Shl<i16> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: i16) -> i128`[src]

Performs the `<<` operation.

### `impl<'a> Shl<&'a isize> for i128`1.0.0[src]

#### `type Output = <i128 as Shl<isize>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: &'a isize) -> <i128 as Shl<isize>>::Output`[src]

Performs the `<<` operation.

### `impl Shl<i128> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: i128) -> i128`[src]

Performs the `<<` operation.

### `impl Shl<u32> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: u32) -> i128`[src]

Performs the `<<` operation.

### `impl<'a> Shl<u128> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Shl<u128>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: u128) -> <i128 as Shl<u128>>::Output`[src]

Performs the `<<` operation.

### `impl<'a> Shl<u64> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Shl<u64>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: u64) -> <i128 as Shl<u64>>::Output`[src]

Performs the `<<` operation.

### `impl<'a> Shl<&'a u32> for i128`1.0.0[src]

#### `type Output = <i128 as Shl<u32>>::Output`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: &'a u32) -> <i128 as Shl<u32>>::Output`[src]

Performs the `<<` operation.

### `impl Shl<i8> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `<<` operator.

#### `fn shl(self, other: i8) -> i128`[src]

Performs the `<<` operation.

### `impl BitAnd<i128> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `&` operator.

#### `fn bitand(self, rhs: i128) -> i128`[src]

Performs the `&` operation.

### `impl<'a> BitAnd<&'a i128> for i128`1.0.0[src]

#### `type Output = <i128 as BitAnd<i128>>::Output`

The resulting type after applying the `&` operator.

#### `fn bitand(self, other: &'a i128) -> <i128 as BitAnd<i128>>::Output`[src]

Performs the `&` operation.

### `impl<'a, 'b> BitAnd<&'a i128> for &'b i128`1.0.0[src]

#### `type Output = <i128 as BitAnd<i128>>::Output`

The resulting type after applying the `&` operator.

#### `fn bitand(self, other: &'a i128) -> <i128 as BitAnd<i128>>::Output`[src]

Performs the `&` operation.

### `impl<'a> BitAnd<i128> for &'a i128`1.0.0[src]

#### `type Output = <i128 as BitAnd<i128>>::Output`

The resulting type after applying the `&` operator.

#### `fn bitand(self, other: i128) -> <i128 as BitAnd<i128>>::Output`[src]

Performs the `&` operation.

### `impl Default for i128`1.0.0[src]

#### `fn default() -> i128`[src]

Returns the default value of `0`

### `impl ShlAssign<u128> for i128`1.8.0[src]

#### `fn shl_assign(&mut self, other: u128)`[src]

Performs the `<<=` operation.

### `impl ShlAssign<i32> for i128`1.8.0[src]

#### `fn shl_assign(&mut self, other: i32)`[src]

Performs the `<<=` operation.

### `impl<'a> ShlAssign<&'a u32> for i128`1.22.0[src]

#### `fn shl_assign(&mut self, other: &'a u32)`[src]

Performs the `<<=` operation.

### `impl<'a> ShlAssign<&'a u16> for i128`1.22.0[src]

#### `fn shl_assign(&mut self, other: &'a u16)`[src]

Performs the `<<=` operation.

### `impl<'a> ShlAssign<&'a i64> for i128`1.22.0[src]

#### `fn shl_assign(&mut self, other: &'a i64)`[src]

Performs the `<<=` operation.

### `impl<'a> ShlAssign<&'a i128> for i128`1.22.0[src]

#### `fn shl_assign(&mut self, other: &'a i128)`[src]

Performs the `<<=` operation.

### `impl<'a> ShlAssign<&'a i8> for i128`1.22.0[src]

#### `fn shl_assign(&mut self, other: &'a i8)`[src]

Performs the `<<=` operation.

### `impl<'a> ShlAssign<&'a u128> for i128`1.22.0[src]

#### `fn shl_assign(&mut self, other: &'a u128)`[src]

Performs the `<<=` operation.

### `impl ShlAssign<u64> for i128`1.8.0[src]

#### `fn shl_assign(&mut self, other: u64)`[src]

Performs the `<<=` operation.

### `impl ShlAssign<isize> for i128`1.8.0[src]

#### `fn shl_assign(&mut self, other: isize)`[src]

Performs the `<<=` operation.

### `impl ShlAssign<i8> for i128`1.8.0[src]

#### `fn shl_assign(&mut self, other: i8)`[src]

Performs the `<<=` operation.

### `impl ShlAssign<u16> for i128`1.8.0[src]

#### `fn shl_assign(&mut self, other: u16)`[src]

Performs the `<<=` operation.

### `impl<'a> ShlAssign<&'a usize> for i128`1.22.0[src]

#### `fn shl_assign(&mut self, other: &'a usize)`[src]

Performs the `<<=` operation.

### `impl ShlAssign<u8> for i128`1.8.0[src]

#### `fn shl_assign(&mut self, other: u8)`[src]

Performs the `<<=` operation.

### `impl ShlAssign<i64> for i128`1.8.0[src]

#### `fn shl_assign(&mut self, other: i64)`[src]

Performs the `<<=` operation.

### `impl<'a> ShlAssign<&'a u8> for i128`1.22.0[src]

#### `fn shl_assign(&mut self, other: &'a u8)`[src]

Performs the `<<=` operation.

### `impl ShlAssign<usize> for i128`1.8.0[src]

#### `fn shl_assign(&mut self, other: usize)`[src]

Performs the `<<=` operation.

### `impl ShlAssign<u32> for i128`1.8.0[src]

#### `fn shl_assign(&mut self, other: u32)`[src]

Performs the `<<=` operation.

### `impl<'a> ShlAssign<&'a i32> for i128`1.22.0[src]

#### `fn shl_assign(&mut self, other: &'a i32)`[src]

Performs the `<<=` operation.

### `impl ShlAssign<i16> for i128`1.8.0[src]

#### `fn shl_assign(&mut self, other: i16)`[src]

Performs the `<<=` operation.

### `impl<'a> ShlAssign<&'a u64> for i128`1.22.0[src]

#### `fn shl_assign(&mut self, other: &'a u64)`[src]

Performs the `<<=` operation.

### `impl ShlAssign<i128> for i128`1.8.0[src]

#### `fn shl_assign(&mut self, other: i128)`[src]

Performs the `<<=` operation.

### `impl<'a> ShlAssign<&'a i16> for i128`1.22.0[src]

#### `fn shl_assign(&mut self, other: &'a i16)`[src]

Performs the `<<=` operation.

### `impl<'a> ShlAssign<&'a isize> for i128`1.22.0[src]

#### `fn shl_assign(&mut self, other: &'a isize)`[src]

Performs the `<<=` operation.

### `impl<'a> Div<&'a i128> for i128`1.0.0[src]

#### `type Output = <i128 as Div<i128>>::Output`

The resulting type after applying the `/` operator.

#### `fn div(self, other: &'a i128) -> <i128 as Div<i128>>::Output`[src]

Performs the `/` operation.

### `impl Div<i128> for i128`1.0.0[src]

This operation rounds towards zero, truncating any fractional part of the exact result.

#### `type Output = i128`

The resulting type after applying the `/` operator.

#### `fn div(self, other: i128) -> i128`[src]

Performs the `/` operation.

### `impl<'a> Div<i128> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Div<i128>>::Output`

The resulting type after applying the `/` operator.

#### `fn div(self, other: i128) -> <i128 as Div<i128>>::Output`[src]

Performs the `/` operation.

### `impl<'a, 'b> Div<&'a i128> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Div<i128>>::Output`

The resulting type after applying the `/` operator.

#### `fn div(self, other: &'a i128) -> <i128 as Div<i128>>::Output`[src]

Performs the `/` operation.

### `impl<'a> BitXorAssign<&'a i128> for i128`1.22.0[src]

#### `fn bitxor_assign(&mut self, other: &'a i128)`[src]

Performs the `^=` operation.

### `impl BitXorAssign<i128> for i128`1.8.0[src]

#### `fn bitxor_assign(&mut self, other: i128)`[src]

Performs the `^=` operation.

### `impl<'a> BitOrAssign<&'a i128> for i128`1.22.0[src]

#### `fn bitor_assign(&mut self, other: &'a i128)`[src]

Performs the `|=` operation.

### `impl BitOrAssign<i128> for i128`1.8.0[src]

#### `fn bitor_assign(&mut self, other: i128)`[src]

Performs the `|=` operation.

### `impl BitAndAssign<i128> for i128`1.8.0[src]

#### `fn bitand_assign(&mut self, other: i128)`[src]

Performs the `&=` operation.

### `impl<'a> BitAndAssign<&'a i128> for i128`1.22.0[src]

#### `fn bitand_assign(&mut self, other: &'a i128)`[src]

Performs the `&=` operation.

### `impl<'a> Add<i128> for &'a i128`1.0.0[src]

#### `type Output = <i128 as Add<i128>>::Output`

The resulting type after applying the `+` operator.

#### `fn add(self, other: i128) -> <i128 as Add<i128>>::Output`[src]

Performs the `+` operation.

### `impl<'a, 'b> Add<&'a i128> for &'b i128`1.0.0[src]

#### `type Output = <i128 as Add<i128>>::Output`

The resulting type after applying the `+` operator.

#### `fn add(self, other: &'a i128) -> <i128 as Add<i128>>::Output`[src]

Performs the `+` operation.

### `impl Add<i128> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `+` operator.

#### `fn add(self, other: i128) -> i128`[src]

Performs the `+` operation.

### `impl<'a> Add<&'a i128> for i128`1.0.0[src]

#### `type Output = <i128 as Add<i128>>::Output`

The resulting type after applying the `+` operator.

#### `fn add(self, other: &'a i128) -> <i128 as Add<i128>>::Output`[src]

Performs the `+` operation.

### `impl LowerHex for i128`1.0.0[src]

#### `fn fmt(&self, f: &mut Formatter) -> Result<(), Error>`[src]

Formats the value using the given formatter.

### `impl Product<i128> for i128`1.12.0[src]

#### `fn product<I>(iter: I) -> i128 where    I: Iterator<Item = i128>, `[src]

Method which takes an iterator and generates `Self` from the elements by multiplying the items. Read more

### `impl<'a> Product<&'a i128> for i128`1.12.0[src]

#### `fn product<I>(iter: I) -> i128 where    I: Iterator<Item = &'a i128>, `[src]

Method which takes an iterator and generates `Self` from the elements by multiplying the items. Read more

### `impl Display for i128`1.0.0[src]

#### `fn fmt(&self, f: &mut Formatter) -> Result<(), Error>`[src]

Formats the value using the given formatter. Read more

### `impl<'a> BitOr<i128> for &'a i128`1.0.0[src]

#### `type Output = <i128 as BitOr<i128>>::Output`

The resulting type after applying the `|` operator.

#### `fn bitor(self, other: i128) -> <i128 as BitOr<i128>>::Output`[src]

Performs the `|` operation.

### `impl BitOr<i128> for i128`1.0.0[src]

#### `type Output = i128`

The resulting type after applying the `|` operator.

#### `fn bitor(self, rhs: i128) -> i128`[src]

Performs the `|` operation.

### `impl<'a, 'b> BitOr<&'a i128> for &'b i128`1.0.0[src]

#### `type Output = <i128 as BitOr<i128>>::Output`

The resulting type after applying the `|` operator.

#### `fn bitor(self, other: &'a i128) -> <i128 as BitOr<i128>>::Output`[src]

Performs the `|` operation.

### `impl<'a> BitOr<&'a i128> for i128`1.0.0[src]

#### `type Output = <i128 as BitOr<i128>>::Output`

The resulting type after applying the `|` operator.

#### `fn bitor(self, other: &'a i128) -> <i128 as BitOr<i128>>::Output`[src]

Performs the `|` operation.

### `impl CastInto<i128> for i128`[src]

#### `fn cast(self) -> i128`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

### `impl CastInto<u64> for i128`[src]

#### `fn cast(self) -> u64`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

### `impl CastInto<u128> for i128`[src]

#### `fn cast(self) -> u128`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

### `impl CastInto<u32> for i128`[src]

#### `fn cast(self) -> u32`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

### `impl CastInto<i32> for i128`[src]

#### `fn cast(self) -> i32`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

### `impl CastInto<usize> for i128`[src]

#### `fn cast(self) -> usize`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

### `impl CastInto<i64> for i128`[src]

#### `fn cast(self) -> i64`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

### `impl CastInto<isize> for i128`[src]

#### `fn cast(self) -> isize`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

### `impl Int for i128`[src]

#### `type OtherSign = u128`

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

Type with the same width but other signedness

#### `type UnsignedInt = u128`

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

Unsigned version of Self

#### `fn extract_sign(self) -> (bool, u128)`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

Extracts the sign from self and returns a tuple. Read more

#### `fn unsigned(self) -> u128`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

#### `fn from_unsigned(me: u128) -> i128`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

#### `const BITS: u32`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

The bitwidth of the int type

#### `const ZERO: i128`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

#### `const ONE: i128`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

#### `fn from_bool(b: bool) -> i128`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

#### `fn max_value() -> i128`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

#### `fn min_value() -> i128`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

#### `fn wrapping_add(self, other: i128) -> i128`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

#### `fn wrapping_mul(self, other: i128) -> i128`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

#### `fn wrapping_sub(self, other: i128) -> i128`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

#### `fn wrapping_shl(self, other: u32) -> i128`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

#### `fn overflowing_add(self, other: i128) -> (i128, bool)`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

#### `fn aborting_div(self, other: i128) -> i128`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

#### `fn aborting_rem(self, other: i128) -> i128`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

#### `fn leading_zeros(self) -> u32`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

### `impl LargeInt for i128`[src]

#### `type LowHalf = u64`

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

#### `type HighHalf = i64`

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

#### `fn low(self) -> u64`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

#### `fn low_as_high(low: u64) -> i64`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

#### `fn high(self) -> i64`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

#### `fn high_as_low(high: i64) -> u64`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

#### `fn from_parts(low: u64, high: i64) -> i128`[src]

🔬 This is a nightly-only experimental API. (`compiler_builtins_lib`)

Compiler builtins. Will never become stable.

## Blanket Implementations

### `impl<T, U> TryFrom for T where    T: From<U>, `[src]

#### `type Error = !`

🔬 This is a nightly-only experimental API. (`try_from `#33417)

The type returned in the event of a conversion error.

#### `fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>`[src]

🔬 This is a nightly-only experimental API. (`try_from `#33417)

Performs the conversion.

### `impl<T> From for T`[src]

#### `fn from(t: T) -> T`[src]

Performs the conversion.

### `impl<T, U> TryInto for T where    U: TryFrom<T>, `[src]

#### `type Error = <U as TryFrom<T>>::Error`

🔬 This is a nightly-only experimental API. (`try_from `#33417)

The type returned in the event of a conversion error.

#### `fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>`[src]

🔬 This is a nightly-only experimental API. (`try_from `#33417)

Performs the conversion.

### `impl<T, U> Into for T where    U: From<T>, `[src]

#### `fn into(self) -> U`[src]

Performs the conversion.

### `impl<T> Borrow for T where    T: ?Sized, `[src]

#### ⓘImportant traits for &'a mut I### Important traits for &'a mut I `impl<'a, I> Iterator for &'a mut I where    I: Iterator + ?Sized,  type Item = <I as Iterator>::Item;impl<'a, R: Read + ?Sized> Read for &'a mut Rimpl<'a, W: Write + ?Sized> Write for &'a mut W``fn borrow(&self) -> &T`[src]

Immutably borrows from an owned value. Read more

### `impl<T> BorrowMut for T where    T: ?Sized, `[src]

#### ⓘImportant traits for &'a mut I### Important traits for &'a mut I `impl<'a, I> Iterator for &'a mut I where    I: Iterator + ?Sized,  type Item = <I as Iterator>::Item;impl<'a, R: Read + ?Sized> Read for &'a mut Rimpl<'a, W: Write + ?Sized> Write for &'a mut W``fn borrow_mut(&mut self) -> &mut T`[src]

Mutably borrows from an owned value. Read more

### `impl<T> Any for T where    T: 'static + ?Sized, `[src]

#### `fn get_type_id(&self) -> TypeId`[src]

🔬 This is a nightly-only experimental API. (`get_type_id `#27745)

this method will likely be replaced by an associated static

Gets the `TypeId` of `self`. Read more

### `impl<T> ToOwned for T where    T: Clone, `[src]

#### `fn to_owned(&self) -> T`[src]

Creates owned data from borrowed data, usually by cloning. Read more

#### `fn clone_into(&self, target: &mut T)`[src]

🔬 This is a nightly-only experimental API. (`toowned_clone_into `#41263)

### `impl<T> ToString for T where    T: Display + ?Sized, `[src]
#### `fn to_string(&self) -> String`[src]
Converts the given value to a `String`. Read more