Primitive Type i128

impl i128

1.43.0 · source

pub const MIN: i128 = -170_141_183_460_469_231_731_687_303_715_884_105_728i128

该整数类型可以表示的最小值 (−2¹²⁷).

Examples

基本用法：

assert_eq!(i128::MIN, -170141183460469231731687303715884105728);

1.43.0 · source

pub const MAX: i128 = 170_141_183_460_469_231_731_687_303_715_884_105_727i128

该整数类型可以表示的最大值 (2¹²⁷ − 1).

Examples

基本用法：

assert_eq!(i128::MAX, 170141183460469231731687303715884105727);

1.53.0 · source

pub const BITS: u32 = 128u32

此整数类型的大小 (以位为单位)。

Examples

assert_eq!(i128::BITS, 128);

1.0.0 · source

pub fn from_str_radix(src: &str, radix: u32) -> Result<i128, ParseIntError>

将给定基数的字符串切片转换为整数。

该字符串应为可选的 + 或 - 符号，后跟数字。前导和尾随空格表示错误。根据 radix，数字是这些字符的子集：

0-9
a-z
A-Z

Panics

如果 radix 不在 2 到 36 之间，则此函数 panics。

Examples

基本用法：

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

1.0.0 (const: 1.32.0) · source

pub const fn count_ones(self) -> u32

返回 self 二进制表示形式中的位数。

Examples

基本用法：

let n = 0b100_0000i128;

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

1.0.0 (const: 1.32.0) · source

pub const fn count_zeros(self) -> u32

返回 self 二进制表示形式中的零数。

Examples

基本用法：

assert_eq!(i128::MAX.count_zeros(), 1);

1.0.0 (const: 1.32.0) · source

pub const fn leading_zeros(self) -> u32

返回 self 二进制表示形式中前导零的数目。

根据您对值的处理方式，您可能还对 ilog2 函数感兴趣，它返回一致的数字，即使类型变宽。

Examples

基本用法：

let n = -1i128;

assert_eq!(n.leading_zeros(), 0);

1.0.0 (const: 1.32.0) · source

pub const fn trailing_zeros(self) -> u32

返回 self 二进制表示形式中的尾随零数。

Examples

基本用法：

let n = -4i128;

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

1.46.0 (const: 1.46.0) · source

pub const fn leading_ones(self) -> u32

返回 self 二进制表示形式中前导数字。

Examples

基本用法：

let n = -1i128;

assert_eq!(n.leading_ones(), 128);

1.46.0 (const: 1.46.0) · source

pub const fn trailing_ones(self) -> u32

返回 self 二进制表示形式中的尾随数字。

Examples

基本用法：

let n = 3i128;

assert_eq!(n.trailing_ones(), 2);

1.0.0 (const: 1.32.0) · source

pub const fn rotate_left(self, n: u32) -> i128

将位左移指定的量 n，将截断的位包装到结果整数的末尾。

请注意，此操作与 << 移位运算符不同！

Examples

基本用法：

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

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

1.0.0 (const: 1.32.0) · source

pub const fn rotate_right(self, n: u32) -> i128

将位右移指定的量 n，将截断的位包装到结果整数的开头。

请注意，此操作与 >> 移位运算符不同！

Examples

基本用法：

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

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

1.0.0 (const: 1.32.0) · source

pub const fn swap_bytes(self) -> i128

反转整数的字节顺序。

Examples

基本用法：

let n = 0x12345678901234567890123456789012i128;

let m = n.swap_bytes();

assert_eq!(m, 0x12907856341290785634129078563412);

1.37.0 (const: 1.37.0) · source

pub const fn reverse_bits(self) -> i128

反转整数中的位顺序。最低有效位变为最高有效位，第二最低有效位变为第二最高有效位，依此类推。

Examples

基本用法：

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

assert_eq!(m, 0x48091e6a2c48091e6a2c48091e6a2c48);
assert_eq!(0, 0i128.reverse_bits());

1.0.0 (const: 1.32.0) · source

pub const fn from_be(x: i128) -> i128

将整数从大端字节序转换为目标的字节序。

在大端节序序上，这是个禁忌。在小端字节序上，字节被交换。

Examples

基本用法：

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())
}

1.0.0 (const: 1.32.0) · source

pub const fn from_le(x: i128) -> i128

将整数从小端字节序转换为目标的字节序。

在小端字节序上，这是个禁忌。在大字节序中，字节被交换。

Examples

基本用法：

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())
}

1.0.0 (const: 1.32.0) · source

pub const fn to_be(self) -> i128

将 self 从目标的字节序转换为大字节序。

在大端节序序上，这是个禁忌。在小端字节序上，字节被交换。

Examples

基本用法：

let n = 0x1Ai128;

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

1.0.0 (const: 1.32.0) · source

pub const fn to_le(self) -> i128

将 self 从目标的字节序转换为 Little Endian。

在小端字节序上，这是个禁忌。在大字节序中，字节被交换。

Examples

基本用法：

let n = 0x1Ai128;

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

1.0.0 (const: 1.47.0) · source

pub const fn checked_add(self, rhs: i128) -> Option<i128>

检查整数加法。计算 self + rhs，如果发生溢出则返回 None。

Examples

基本用法：

assert_eq!((i128::MAX - 2).checked_add(1), Some(i128::MAX - 1));
assert_eq!((i128::MAX - 2).checked_add(3), None);

const: unstable · source

pub unsafe fn unchecked_add(self, rhs: i128) -> i128

🔬This is a nightly-only experimental API. (unchecked_math #85122)

未经检查的整数加法。假设不会发生溢出，则计算 self + rhs。

Safety

当以下情况时，这导致未定义的行为 self + rhs > i128::MAX or self + rhs < i128::MIN, 即当 checked_add 将返回 None 时。

1.66.0 (const: 1.66.0) · source

pub const fn checked_add_unsigned(self, rhs: u128) -> Option<i128>

用无符号整数检查加法。计算 self + rhs，如果发生溢出则返回 None。

Examples

基本用法：

assert_eq!(1i128.checked_add_unsigned(2), Some(3));
assert_eq!((i128::MAX - 2).checked_add_unsigned(3), None);

1.0.0 (const: 1.47.0) · source

pub const fn checked_sub(self, rhs: i128) -> Option<i128>

检查整数减法。计算 self - rhs，如果发生溢出则返回 None。

Examples

基本用法：

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

const: unstable · source

pub unsafe fn unchecked_sub(self, rhs: i128) -> i128

🔬This is a nightly-only experimental API. (unchecked_math #85122)

未经检查的整数减法。假设不会发生溢出，则计算 self - rhs。

Safety

当以下情况时，这导致未定义的行为 self - rhs > i128::MAX or self - rhs < i128::MIN, 即当 checked_sub 将返回 None 时。

1.66.0 (const: 1.66.0) · source

pub const fn checked_sub_unsigned(self, rhs: u128) -> Option<i128>

用无符号整数检查减法。计算 self - rhs，如果发生溢出则返回 None。

Examples

基本用法：

assert_eq!(1i128.checked_sub_unsigned(2), Some(-1));
assert_eq!((i128::MIN + 2).checked_sub_unsigned(3), None);

1.0.0 (const: 1.47.0) · source

pub const fn checked_mul(self, rhs: i128) -> Option<i128>

检查整数乘法。计算 self * rhs，如果发生溢出则返回 None。

Examples

基本用法：

assert_eq!(i128::MAX.checked_mul(1), Some(i128::MAX));
assert_eq!(i128::MAX.checked_mul(2), None);

const: unstable · source

pub unsafe fn unchecked_mul(self, rhs: i128) -> i128

🔬This is a nightly-only experimental API. (unchecked_math #85122)

基本用法：

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

const: unstable · source

pub unsafe fn unchecked_shl(self, rhs: u32) -> i128

🔬This is a nightly-only experimental API. (unchecked_math #85122)

未检查的左移。计算 self << rhs，假设 rhs 小于 self 中的位数。

Safety

如果 rhs 大于或等于 self 中的位数，则会导致未定义的行为，即

当 checked_shl 返回 None 时。

1.7.0 (const: 1.47.0) · source

pub const fn checked_shr(self, rhs: u32) -> Option<i128>

检查右移。计算 self >> rhs，如果 rhs 大于或等于 self 中的位数，则返回 None。

Examples

基本用法：

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

const: unstable · source

pub unsafe fn unchecked_shr(self, rhs: u32) -> i128

🔬This is a nightly-only experimental API. (unchecked_math #85122)

未检查右移。计算 self >> rhs，假设 rhs 小于 self 中的位数。

Safety

assert_eq!(5i128.saturating_div(2), 2);
assert_eq!(i128::MAX.saturating_div(-1), i128::MIN + 1);
assert_eq!(i128::MIN.saturating_div(-1), i128::MAX);

let _ = 1i128.saturating_div(0);

1.34.0 (const: 1.50.0) · source

pub const fn saturating_pow(self, exp: u32) -> i128

饱和整数幂。计算 self.pow(exp)，在数字范围内饱和，而不是溢出。

Examples

基本用法：

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);

1.0.0 (const: 1.32.0) · source

pub const fn wrapping_add(self, rhs: i128) -> i128

包装 (modular) 添加。计算 self + rhs，在类型的边界处回绕。

Examples

基本用法：

assert_eq!(100i128.wrapping_add(27), 127);
assert_eq!(i128::MAX.wrapping_add(2), i128::MIN + 1);

1.66.0 (const: 1.66.0) · source

pub const fn wrapping_add_unsigned(self, rhs: u128) -> i128

用无符号整数包装 (modular) 加法。计算 self + rhs，在类型的边界处回绕。

Examples

基本用法：

assert_eq!(100i128.wrapping_add_unsigned(27), 127);
assert_eq!(i128::MAX.wrapping_add_unsigned(2), i128::MIN + 1);

1.0.0 (const: 1.32.0) · source

pub const fn wrapping_sub(self, rhs: i128) -> i128

包装 (modular) 减法。计算 self - rhs，在类型的边界处回绕。

Examples

基本用法：

assert_eq!(0i128.wrapping_sub(127), -127);
assert_eq!((-2i128).wrapping_sub(i128::MAX), i128::MAX);

1.66.0 (const: 1.66.0) · source

pub const fn wrapping_sub_unsigned(self, rhs: u128) -> i128

用无符号整数包装 (modular) 减法。计算 self - rhs，在类型的边界处回绕。

Examples

基本用法：

assert_eq!(0i128.wrapping_sub_unsigned(127), -127);
assert_eq!((-2i128).wrapping_sub_unsigned(u128::MAX), -1);

1.0.0 (const: 1.32.0) · source

pub const fn wrapping_mul(self, rhs: i128) -> i128

包装 (modular) 乘法。计算 self * rhs，在类型的边界处回绕。

Examples

基本用法：

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

1.2.0 (const: 1.52.0) · source

pub const fn wrapping_div(self, rhs: i128) -> i128

包装 (modular) 分区。计算 self / rhs，在类型的边界处回绕。

可能发生这种换行的唯一情况是将 MIN / -1 除以有符号类型 (其中 MIN 是该类型的负最小值)。这等效于 -MIN，它是一个太大的正值，无法在类型中表示。在这种情况下，此函数将返回 MIN 本身。

Panics

如果 rhs 是，这个函数会 panic 0.

Examples

基本用法：

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

1.38.0 (const: 1.52.0) · source

pub const fn wrapping_div_euclid(self, rhs: i128) -> i128

包装欧几里得除法。计算 self.div_euclid(rhs)，在类型的边界处回绕。

包装只会在 MIN / -1 上的带符号类型 (其中 MIN 是该类型的负最小值) 上发生。这等效于 -MIN，它是一个太大的正值，无法在类型中表示。在这种情况下，此方法将返回 MIN 本身。

Panics

如果 rhs 是，这个函数会 panic 0.

Examples

基本用法：

assert_eq!(100i128.wrapping_div_euclid(10), 10);
assert_eq!((-128i8).wrapping_div_euclid(-1), -128);

1.2.0 (const: 1.52.0) · source

pub const fn wrapping_rem(self, rhs: i128) -> i128

包装 (modular) 余数。计算 self % rhs，在类型的边界处回绕。

这种折回实际上在数学上从来没有发生过。实现工件会导致 x % y 对于带符号类型的 MIN / -1 无效 (其中 MIN 为负最小值)。

在这种情况下，此函数返回 0。

Panics

如果 rhs 是，这个函数会 panic 0.

Examples

基本用法：

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

1.38.0 (const: 1.52.0) · source

pub const fn wrapping_rem_euclid(self, rhs: i128) -> i128

包装欧几里得的余数。计算 self.rem_euclid(rhs)，在类型的边界处回绕。

包装只会在 MIN % -1 上的带符号类型 (其中 MIN 是该类型的负最小值) 上发生。在这种情况下，此方法返回 0.

Panics

如果 rhs 是，这个函数会 panic 0.

Examples

基本用法：

assert_eq!(100i128.wrapping_rem_euclid(10), 0);
assert_eq!((-128i8).wrapping_rem_euclid(-1), 0);

1.2.0 (const: 1.32.0) · source

pub const fn wrapping_neg(self) -> i128

包装 (modular) 取反。计算 -self，在类型的边界处回绕。

可能发生这种换行的唯一情况是对有符号类型的 MIN 求反 (其中 MIN 是该类型的负最小值) ; 否则，可能会发生这种换行。这是一个太大的正值，无法在类型中表示。在这种情况下，此函数将返回 MIN 本身。

Examples

基本用法：

assert_eq!(100i128.wrapping_neg(), -100);
assert_eq!(i128::MIN.wrapping_neg(), i128::MIN);

1.2.0 (const: 1.32.0) · source

pub const fn wrapping_shl(self, rhs: u32) -> i128

无 Panic - 按位左移；产生 self << mask(rhs)，其中 mask 删除 rhs 的所有高位，这些高位将导致移位超过该类型的位宽。

注意，这与左旋不同；环绕左移的 RHS 限于该类型的范围，而不是从 LHS 移出的位返回到另一端。

所有原始整数类型都实现了 rotate_left 函数，而您可能想要的是 rotate_left 函数。

Examples

基本用法：

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

1.2.0 (const: 1.32.0) · source

pub const fn wrapping_shr(self, rhs: u32) -> i128

无 Panic - 按位右移；产生 self >> mask(rhs)，其中 mask 删除 rhs 的所有高位，这些高位将导致移位超过该类型的位宽。

注意，这与右旋转不同。换行右移的 RHS 限于类型的范围，而不是从 LHS 移出的位返回到另一端。

所有原始整数类型都实现了 rotate_right 函数，而您可能想要的是 rotate_right 函数。

Examples

基本用法：

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

1.13.0 (const: 1.32.0) · source

pub const fn wrapping_abs(self) -> i128

包装 (modular) 绝对值。计算 self.abs()，在类型的边界处回绕。

可能发生这种换行的唯一情况是，当类型取负的最小值的绝对值时；这是一个太大的正值，无法在类型中表示。在这种情况下，此函数将返回 MIN 本身。

Examples

基本用法：

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

1.51.0 (const: 1.51.0) · source

pub const fn unsigned_abs(self) -> u128

计算 self 的绝对值，而不会引起任何包装或 panic。

Examples

基本用法：

assert_eq!(100i128.unsigned_abs(), 100u128);
assert_eq!((-100i128).unsigned_abs(), 100u128);
assert_eq!((-128i8).unsigned_abs(), 128u8);

1.34.0 (const: 1.50.0) · source

pub const fn wrapping_pow(self, exp: u32) -> i128

包装 (modular) 指数。计算 self.pow(exp)，在类型的边界处回绕。

Examples

基本用法：

assert_eq!(3i128.wrapping_pow(4), 81);
assert_eq!(3i8.wrapping_pow(5), -13);
assert_eq!(3i8.wrapping_pow(6), -39);

1.7.0 (const: 1.32.0) · source

pub const fn overflowing_add(self, rhs: i128) -> (i128, bool)

计算 self + rhs

返回一个加法元组以及一个布尔值，该布尔值指示是否会发生算术溢出。如果将发生溢出，则返回包装的值。

Examples

基本用法：

assert_eq!(5i128.overflowing_add(2), (7, false));
assert_eq!(i128::MAX.overflowing_add(1), (i128::MIN, true));

const: unstable · source

pub fn carrying_add(self, rhs: i128, carry: bool) -> (i128, bool)

🔬This is a nightly-only experimental API. (bigint_helper_methods #85532)

计算 self + rhs + carry 并检查溢出。

执行两个整数操作数和一个进位位的 “ternary addition”，并返回一个总和元组以及一个指示是否会发生算术溢出的布尔值。溢出时，返回包装后的值。

这允许将多个加法链接在一起以创建更广泛的加法，并且对于 bignum 加法很有用。这种方法应该只用于最重要的词; 对于不太重要的词，无符号方法

u128::carrying_add 应该使用。

此方法返回的输出布尔值不是进位标志，不应该添加到更重要的词中。

如果输入进位为假，则此方法等同于 overflowing_add。

Examples

#![feature(bigint_helper_methods)]
// 只有最重要的字被签名。
//   10  MAX    (a = 10 × 2^128 + 2^128 - 1)
// + -5    9    (b = -5 × 2^128 + 9)
// ---------
//    6    8    (sum = 6 × 2^128 + 8)

let (a1, a0): (i128, u128) = (10, u128::MAX);
let (b1, b0): (i128, u128) = (-5, 9);
let carry0 = false;

// u128::carrying_add for the less significant words
let (sum0, carry1) = a0.carrying_add(b0, carry0);
assert_eq!(carry1, true);

// i128::carrying_add for the most significant word
let (sum1, overflow) = a1.carrying_add(b1, carry1);
assert_eq!(overflow, false);

assert_eq!((sum1, sum0), (6, 8));

1.66.0 (const: 1.66.0) · source

pub const fn overflowing_add_unsigned(self, rhs: u128) -> (i128, bool)

使用无符号 rhs 计算 self + rhs

返回一个加法元组以及一个布尔值，该布尔值指示是否会发生算术溢出。如果将发生溢出，则返回包装的值。

Examples

基本用法：

assert_eq!(1i128.overflowing_add_unsigned(2), (3, false));
assert_eq!((i128::MIN).overflowing_add_unsigned(u128::MAX), (i128::MAX, false));
assert_eq!((i128::MAX - 2).overflowing_add_unsigned(3), (i128::MIN, true));

1.7.0 (const: 1.32.0) · source

pub const fn overflowing_sub(self, rhs: i128) -> (i128, bool)

计算 self-rhs

返回一个减法的元组以及一个布尔值，该布尔值指示是否会发生算术溢出。如果将发生溢出，则返回包装的值。

Examples

基本用法：

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

const: unstable · source

pub fn borrowing_sub(self, rhs: i128, borrow: bool) -> (i128, bool)

🔬This is a nightly-only experimental API. (bigint_helper_methods #85532)

计算 self − rhs − borrow 并检查溢出。

通过从 self 中减去一个整数操作数和一个借用输入位来执行 “ternary subtraction”，并返回一个差元组以及一个指示是否会发生算术溢出的布尔值。

溢出时，返回包装后的值。

这允许将多个减法链接在一起以创建更广泛的减法，并且对于 bignum 减法很有用。这种方法应该只用于最重要的词; 对于不太重要的词，无符号方法

u128::borrowing_sub 应该使用。

此方法返回的输出布尔值不是借用标志，应该不从更重要的词中减去。

如果输入借用为 false，该方法等同于 overflowing_sub。

Examples

#![feature(bigint_helper_methods)]
// 只有最重要的字被签名。
//    6    8    (a = 6 × 2^128 + 8)
// - -5    9    (b = -5 × 2^128 + 9)
// ---------
//   10  MAX    (diff = 10 × 2^128 + 2^128 - 1)

let (a1, a0): (i128, u128) = (6, 8);
let (b1, b0): (i128, u128) = (-5, 9);
let borrow0 = false;

// u128::borrowing_sub for the less significant words
let (diff0, borrow1) = a0.borrowing_sub(b0, borrow0);
assert_eq!(borrow1, true);

// i128::borrowing_sub for the most significant word
let (diff1, overflow) = a1.borrowing_sub(b1, borrow1);
assert_eq!(overflow, false);

assert_eq!((diff1, diff0), (10, u128::MAX));

1.66.0 (const: 1.66.0) · source

pub const fn overflowing_sub_unsigned(self, rhs: u128) -> (i128, bool)

使用无符号 rhs 计算 self-rhs

返回一个减法的元组以及一个布尔值，该布尔值指示是否会发生算术溢出。如果将发生溢出，则返回包装的值。

Examples

基本用法：

assert_eq!(1i128.overflowing_sub_unsigned(2), (-1, false));
assert_eq!((i128::MAX).overflowing_sub_unsigned(u128::MAX), (i128::MIN, false));
assert_eq!((i128::MIN + 2).overflowing_sub_unsigned(3), (i128::MAX, true));

1.7.0 (const: 1.32.0) · source

pub const fn overflowing_mul(self, rhs: i128) -> (i128, bool)

计算 self 和 rhs 的乘法。

返回乘法的元组以及一个布尔值，该布尔值指示是否会发生算术溢出。如果将发生溢出，则返回包装的值。

Examples

基本用法：

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

1.7.0 (const: 1.52.0) · source

pub const fn overflowing_div(self, rhs: i128) -> (i128, bool)

self 除以 rhs 时计算除数。

返回除数的元组以及指示是否将发生算术溢出的布尔值。如果将发生溢出，则返回 self。

Panics

如果 rhs 是，这个函数会 panic 0.

Examples

基本用法：

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

1.38.0 (const: 1.52.0) · source

pub const fn overflowing_div_euclid(self, rhs: i128) -> (i128, bool)

计算欧几里得除法 self.div_euclid(rhs) 的商。

返回除数的元组以及指示是否将发生算术溢出的布尔值。如果将发生溢出，则返回 self。

Panics

如果 rhs 是，这个函数会 panic 0.

Examples

基本用法：

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

1.7.0 (const: 1.52.0) · source

pub const fn overflowing_rem(self, rhs: i128) -> (i128, bool)

self 除以 rhs 时计算余数。

返回除法运算后的余数元组和一个布尔值，该布尔值指示是否会发生算术溢出。如果将发生溢出，则返回 0。

Panics

如果 rhs 是，这个函数会 panic 0.

Examples

基本用法：

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

1.38.0 (const: 1.52.0) · source

pub const fn overflowing_rem_euclid(self, rhs: i128) -> (i128, bool)

溢出的欧几里得余数。计算 self.rem_euclid(rhs)。

返回除法运算后的余数元组和一个布尔值，该布尔值指示是否会发生算术溢出。如果将发生溢出，则返回 0。

Panics

如果 rhs 是，这个函数会 panic 0.

Examples

基本用法：

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

1.7.0 (const: 1.32.0) · source

pub const fn overflowing_neg(self) -> (i128, bool)

否定 self，如果等于最小值，则溢出。

返回否定形式 self 的元组以及一个布尔值，该布尔值指示是否发生了溢出。如果 self 是最小值 (例如，对于类型 i32 的值，则为 i32::MIN)，则将再次返回该最小值，并且将发生溢出时返回 true。

Examples

基本用法：

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

1.7.0 (const: 1.32.0) · source

pub const fn overflowing_shl(self, rhs: u32) -> (i128, bool)

将 self 左移 rhs 位。

返回 self 的移位版本的元组以及一个布尔值，该布尔值指示 shift 值是否大于或等于位数。如果移位值太大，则将值屏蔽 (N-1)，其中 N 是位数，然后使用该值执行移位。

Examples

基本用法：

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

1.7.0 (const: 1.32.0) · source

pub const fn overflowing_shr(self, rhs: u32) -> (i128, bool)

将 self 右移 rhs 位。

返回 self 的移位版本的元组以及一个布尔值，该布尔值指示 shift 值是否大于或等于位数。如果移位值太大，则将值屏蔽 (N-1)，其中 N 是位数，然后使用该值执行移位。

Examples

基本用法：

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

1.13.0 (const: 1.32.0) · source

pub const fn overflowing_abs(self) -> (i128, bool)

计算 self 的绝对值。

返回 self 的绝对版本的元组以及一个布尔值，该布尔值指示是否发生了溢出。如果 self 是最小值 (e.g., i128::MIN for values of type i128), 然后将再次返回最小值，并在发生溢出时返回 true。

Examples

基本用法：

assert_eq!(10i128.overflowing_abs(), (10, false));
assert_eq!((-10i128).overflowing_abs(), (10, false));
assert_eq!((i128::MIN).overflowing_abs(), (i128::MIN, true));

1.34.0 (const: 1.50.0) · source

pub const fn overflowing_pow(self, exp: u32) -> (i128, bool)

通过平方运算，将自己提升到 exp 的功效。

返回一个指数的元组以及一个 bool，指示是否发生了溢出。

Examples

基本用法：

assert_eq!(3i128.overflowing_pow(4), (81, false));
assert_eq!(3i8.overflowing_pow(5), (-13, true));

1.0.0 (const: 1.50.0) · source

pub const fn pow(self, exp: u32) -> i128

通过平方运算，将自己提升到 exp 的功效。

Examples

基本用法：

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

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

1.38.0 (const: 1.52.0) · source

pub const fn div_euclid(self, rhs: i128) -> i128

计算 self 的欧几里得除以 rhs 的商。

这将计算整数 q，使得 self = q * rhs + r、r = self.rem_euclid(rhs) 和 0 <= r < abs(rhs)。

换句话说，结果是 self / rhs 舍入为整数 q，使得 self >= q * rhs。如果为 self > 0，则等于舍入为零 (Rust 中的默认值) ；如果为 self < 0，则等于朝 +/- 无限取整。

Panics

如果 rhs 为 0 或除法导致溢出，则该函数将为 panic。

Examples

基本用法：

let a: i128 = 7; // or any other integer type
let b = 4;

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

1.38.0 (const: 1.52.0) · source

pub const fn rem_euclid(self, rhs: i128) -> i128

计算 self (mod rhs) 的最小非负余数。

就像通过欧几里得除法算法一样 - 给定 r = self.rem_euclid(rhs)，self = rhs * self.div_euclid(rhs) + r 和 0 <= r < abs(rhs)。

Panics

如果 rhs 为 0 或除法导致溢出，则该函数将为 panic。

Examples

基本用法：

let a: i128 = 7; // or any other integer type
let b = 4;

assert_eq!(a.rem_euclid(b), 3);
assert_eq!((-a).rem_euclid(b), 1);
assert_eq!(a.rem_euclid(-b), 3);
assert_eq!((-a).rem_euclid(-b), 1);

pub const fn div_floor(self, rhs: i128) -> i128

🔬This is a nightly-only experimental API. (int_roundings #88581)

计算 self 和 rhs 的商，将结果四舍五入到负无穷大。

#![feature(int_roundings)]
let a: i128 = 8;
let b = 3;

assert_eq!(a.div_floor(b), 2);
assert_eq!(a.div_floor(-b), -3);
assert_eq!((-a).div_floor(b), -3);
assert_eq!((-a).div_floor(-b), 2);

pub const fn div_ceil(self, rhs: i128) -> i128

🔬This is a nightly-only experimental API. (int_roundings #88581)

计算 self 和 rhs 的商，将结果四舍五入到正无穷大。

#![feature(int_roundings)]
let a: i128 = 8;
let b = 3;

assert_eq!(a.div_ceil(b), 3);
assert_eq!(a.div_ceil(-b), -2);
assert_eq!((-a).div_ceil(b), -2);
assert_eq!((-a).div_ceil(-b), 3);

pub const fn next_multiple_of(self, rhs: i128) -> i128

🔬This is a nightly-only experimental API. (int_roundings #88581)

如果 rhs 为正数，则计算大于或等于 self 的最小值，即 rhs 的倍数。如果 rhs 为负数，则计算小于或等于 rhs 倍数的 self 的最大值。

#![feature(int_roundings)]
assert_eq!(16_i128.next_multiple_of(8), 16);
assert_eq!(23_i128.next_multiple_of(8), 24);
assert_eq!(16_i128.next_multiple_of(-8), 16);
assert_eq!(23_i128.next_multiple_of(-8), 16);
assert_eq!((-16_i128).next_multiple_of(8), -16);
assert_eq!((-23_i128).next_multiple_of(8), -16);
assert_eq!((-16_i128).next_multiple_of(-8), -16);
assert_eq!((-23_i128).next_multiple_of(-8), -24);

pub const fn checked_next_multiple_of(self, rhs: i128) -> Option<i128>

🔬This is a nightly-only experimental API. (int_roundings #88581)

如果 rhs 为正数，则计算大于或等于 self 的最小值，即 rhs 的倍数。

如果 rhs 为负数，则计算小于或等于 rhs 倍数的 self 的最大值。如果 rhs 为零，则返回 None，否则操作会导致溢出。

Examples

基本用法：

#![feature(int_roundings)]
assert_eq!(16_i128.checked_next_multiple_of(8), Some(16));
assert_eq!(23_i128.checked_next_multiple_of(8), Some(24));
assert_eq!(16_i128.checked_next_multiple_of(-8), Some(16));
assert_eq!(23_i128.checked_next_multiple_of(-8), Some(16));
assert_eq!((-16_i128).checked_next_multiple_of(8), Some(-16));
assert_eq!((-23_i128).checked_next_multiple_of(8), Some(-16));
assert_eq!((-16_i128).checked_next_multiple_of(-8), Some(-16));
assert_eq!((-23_i128).checked_next_multiple_of(-8), Some(-24));
assert_eq!(1_i128.checked_next_multiple_of(0), None);
assert_eq!(i128::MAX.checked_next_multiple_of(2), None);

const: unstable · source

pub fn midpoint(self, rhs: i128) -> i128

🔬This is a nightly-only experimental API. (num_midpoint #110840)

计算 self 和 rhs 的中点。

midpoint(a, b) 是 (a + b) >> 1，就好像它是在足够大的带符号整数类型中执行的一样。这意味着结果总是向 negative 无穷大舍入，并且永远不会发生溢出。

Examples

#![feature(num_midpoint)]
assert_eq!(0i128.midpoint(4), 2);
assert_eq!(0i128.midpoint(-1), -1);
assert_eq!((-1i128).midpoint(0), -1);

1.67.0 (const: 1.67.0) · source

pub const fn ilog(self, base: i128) -> u32

返回数字相对于任意底数的对数，向下取整。

由于实现细节，此方法可能未优化； ilog2 可以更有效地产生以 2 为底的结果，而 ilog10 可以更有效地产生以 10 为底的结果。

Panics

如果 self 小于或等于零，或者如果 base 小于，这个函数会 panic 2.

Examples

assert_eq!(5i128.ilog(5), 1);

1.67.0 (const: 1.67.0) · source

pub const fn ilog2(self) -> u32

返回数字的以 2 为底的对数，向下取整。

Panics

如果 self 小于或等于 0，这个函数将会 panic。

Examples

assert_eq!(2i128.ilog2(), 1);

1.67.0 (const: 1.67.0) · source

pub const fn ilog10(self) -> u32

返回数字的以 10 为底的对数，向下取整。

Panics

如果 self 小于或等于 0，这个函数将会 panic。

Example

assert_eq!(10i128.ilog10(), 1);

1.67.0 (const: 1.67.0) · source

pub const fn checked_ilog(self, base: i128) -> Option<u32>

返回数字相对于任意底数的对数，向下取整。

如果数字为 negative 或零，或者基数不至少为，则返回 None 2.

由于实现细节，此方法可能未优化； checked_ilog2 可以更有效地产生以 2 为底的结果，而 checked_ilog10 可以更有效地产生以 10 为底的结果。

Examples

assert_eq!(5i128.checked_ilog(5), Some(1));

1.67.0 (const: 1.67.0) · source

pub const fn checked_ilog2(self) -> Option<u32>

返回数字的以 2 为底的对数，向下取整。

如果数字为负数或零，则返回 None。

Examples

assert_eq!(2i128.checked_ilog2(), Some(1));

1.67.0 (const: 1.67.0) · source

pub const fn checked_ilog10(self) -> Option<u32>

返回数字的以 10 为底的对数，向下取整。

如果数字为负数或零，则返回 None。

Example

assert_eq!(10i128.checked_ilog10(), Some(1));

1.0.0 (const: 1.32.0) · source

pub const fn abs(self) -> i128

计算 self 的绝对值。

溢出行为

的绝对值 i128::MIN 不能表示为 i128, 并尝试计算它会导致溢出。这意味着在这种情况下，处于调试模式的代码将触发 panic，并且优化后的代码将返回

i128::MIN 没有 panic。

Examples

基本用法：

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

1.60.0 (const: 1.60.0) · source

pub const fn abs_diff(self, other: i128) -> u128

计算 self 和 other 之间的绝对差。

这个函数总是通过返回一个无符号整数来返回没有溢出或 panics 的正确答案。

Examples

基本用法：

assert_eq!(100i128.abs_diff(80), 20u128);
assert_eq!(100i128.abs_diff(110), 10u128);
assert_eq!((-100i128).abs_diff(80), 180u128);
assert_eq!((-100i128).abs_diff(-120), 20u128);
assert_eq!(i128::MIN.abs_diff(i128::MAX), u128::MAX);

1.0.0 (const: 1.47.0) · source

pub const fn signum(self) -> i128

返回一个表示 self 的符号的数字。

0 如果数字为零
1 如果数字是正数
-1 如果数字是负数

Examples

基本用法：

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

1.0.0 (const: 1.32.0) · source

pub const fn is_positive(self) -> bool

如果 self 为正数，则返回 true; 如果数字为零或负数，则返回 false。

Examples

基本用法：

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

1.0.0 (const: 1.32.0) · source

pub const fn is_negative(self) -> bool

如果 self 为负，则返回 true; 如果数字为零或正，则返回 false。

Examples

基本用法：

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

1.32.0 (const: 1.44.0) · source

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

以大端 (网络) 字节顺序将这个整数的内存表示形式作为字节数组返回。

Examples

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]);

1.32.0 (const: 1.44.0) · source

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

以小端字节顺序将这个整数的内存表示形式返回为字节数组。

Examples

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]);

1.32.0 (const: 1.44.0) · source

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

将此整数的内存表示作为本机字节顺序的字节数组返回。

由于使用了目标平台的原生字节序，因此，可移植代码应酌情使用 to_be_bytes 或 to_le_bytes。

Examples

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]
    }
);

1.32.0 (const: 1.44.0) · source

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

从其表示形式以 big endian 的字节数组形式创建一个整数值。

Examples

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);

从切片而不是数组开始时，可以使用容易出错的转换 API：

fn read_be_i128(input: &mut &[u8]) -> i128 {
    let (int_bytes, rest) = input.split_at(std::mem::size_of::<i128>());
    *input = rest;
    i128::from_be_bytes(int_bytes.try_into().unwrap())
}

1.32.0 (const: 1.44.0) · source

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

从它的表示形式以 little endian 的字节数组形式创建一个整数值。

Examples

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);

从切片而不是数组开始时，可以使用容易出错的转换 API：

fn read_le_i128(input: &mut &[u8]) -> i128 {
    let (int_bytes, rest) = input.split_at(std::mem::size_of::<i128>());
    *input = rest;
    i128::from_le_bytes(int_bytes.try_into().unwrap())
}

1.32.0 (const: 1.44.0) · source

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

从其内存表示形式创建一个整数值，以原生字节序表示为字节数组。

由于使用了目标平台的原生字节序，因此可移植代码可能希望酌情使用 from_be_bytes 或 from_le_bytes。

Examples

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);

从切片而不是数组开始时，可以使用容易出错的转换 API：

fn read_ne_i128(input: &mut &[u8]) -> i128 {
    let (int_bytes, rest) = input.split_at(std::mem::size_of::<i128>());
    *input = rest;
    i128::from_ne_bytes(int_bytes.try_into().unwrap())
}

1.0.0 (const: 1.32.0) · source

pub const fn min_value() -> i128

👎Deprecating in a future Rust version: replaced by the MIN associated constant on this type

新代码应优先使用 i128::MIN instead.

返回此整数类型可以表示的最小值。

1.0.0 (const: 1.32.0) · source

pub const fn max_value() -> i128

👎Deprecating in a future Rust version: replaced by the MAX associated constant on this type

新代码应优先使用 i128::MAX instead.

返回此整数类型可以表示的最大值。

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);

impl Hash for i128

fn hash<H>(&self, state: &mut H)where H: Hasher,

将该值输入给定的 Hasher。 Read more

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

将这种类型的切片送入给定的 Hasher 中。 Read more

1.42.0 · source§

impl LowerExp for i128

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

使用给定的格式化程序格式化该值。

1.0.0 · source§

使用给定的格式化程序格式化该值。

1.0.0 · source§

impl Ord for i128

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

此方法返回 self 和 other 之间的 Ordering。 Read more

1.21.0 · source§

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

比较并返回两个值中的最大值。 Read more

1.21.0 · source§

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

比较并返回两个值中的最小值。 Read more

1.50.0 · source§

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd<Self>,

将值限制在某个时间间隔内。 Read more

1.0.0 · source§

impl PartialEq<i128> for i128

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

此方法测试 self 和 other 值是否相等，并由 == 使用。

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

此方法测试 !=。默认实现几乎总是足够的，并且不应在没有充分理由的情况下被覆盖。

1.0.0 · source§

fn to_owned(&self) -> T

从借用的数据创建拥有的数据，通常是通过克隆。 Read more

执行转换。

impl<T, U> TryInto for Twhere U: TryFrom<T>,

§

type Error = >::Error

发生转换错误时返回的类型。