Primitive Type u128

1.26.0 ·

Expand description

128 位无符号整数类型。

Implementations§

source §

impl u128

1.43.0 · source

pub const MIN: u128 = 0u128

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

Examples

基本用法：

assert_eq!(u128::MIN, 0);

Run

1.43.0 · source

pub const MAX: u128 = 340_282_366_920_938_463_463_374_607_431_768_211_455u128

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

Examples

基本用法：

assert_eq!(u128::MAX, 340282366920938463463374607431768211455);

Run

1.53.0 · source

pub const BITS: u32 = 128u32

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

Examples

assert_eq!(u128::BITS, 128);

Run

1.0.0 · source

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

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

该字符串应为可选的 + 符号，后跟数字。

前导和尾随空格表示错误。根据 radix，数字是这些字符的子集：

0-9
a-z
A-Z

Panics

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

Examples

基本用法：

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

Run

1.0.0 (const: 1.32.0) · source

pub const fn count_ones(self) -> u32

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

Examples

基本用法：

let n = 0b01001100u128;

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

Run

1.0.0 (const: 1.32.0) · source

pub const fn count_zeros(self) -> u32

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

Examples

基本用法：

assert_eq!(u128::MAX.count_zeros(), 0);

Run

1.0.0 (const: 1.32.0) · source

pub const fn leading_zeros(self) -> u32

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

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

Examples

基本用法：

let n = u128::MAX >> 2;

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

Run

1.0.0 (const: 1.32.0) · source

pub const fn trailing_zeros(self) -> u32

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

Examples

基本用法：

let n = 0b0101000u128;

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

Run

1.46.0 (const: 1.46.0) · source

pub const fn leading_ones(self) -> u32

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

Examples

基本用法：

let n = !(u128::MAX >> 2);

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

Run

1.46.0 (const: 1.46.0) · source

pub const fn trailing_ones(self) -> u32

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

Examples

基本用法：

let n = 0b1010111u128;

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

Run

1.0.0 (const: 1.32.0) · source

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

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

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

Examples

基本用法：

let n = 0x13f40000000000000000000000004f76u128;
let m = 0x4f7613f4;

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

Run

1.0.0 (const: 1.32.0) · source

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

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

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

Examples

基本用法：

let n = 0x4f7613f4u128;
let m = 0x13f40000000000000000000000004f76;

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

Run

1.0.0 (const: 1.32.0) · source

pub const fn swap_bytes(self) -> u128

反转整数的字节顺序。

Examples

基本用法：

let n = 0x12345678901234567890123456789012u128;
let m = n.swap_bytes();

assert_eq!(m, 0x12907856341290785634129078563412);

Run

1.37.0 (const: 1.37.0) · source

pub const fn reverse_bits(self) -> u128

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

Examples

基本用法：

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

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

Run

1.0.0 (const: 1.32.0) · source

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

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

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

Examples

基本用法：

let n = 0x1Au128;

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

Run

1.0.0 (const: 1.32.0) · source

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

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

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

Examples

基本用法：

let n = 0x1Au128;

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

Run

1.0.0 (const: 1.32.0) · source

pub const fn to_be(self) -> u128

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

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

Examples

基本用法：

let n = 0x1Au128;

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

Run

1.0.0 (const: 1.32.0) · source

pub const fn to_le(self) -> u128

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

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

Examples

基本用法：

let n = 0x1Au128;

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

Run

1.0.0 (const: 1.47.0) · source

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

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

Examples

基本用法：

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

Run

const: unstable · source

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

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

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

Safety

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

1.66.0 (const: 1.66.0) · source

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

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

Examples

基本用法：

assert_eq!(1u128.checked_add_signed(2), Some(3));
assert_eq!(1u128.checked_add_signed(-2), None);
assert_eq!((u128::MAX - 2).checked_add_signed(3), None);

Run

1.0.0 (const: 1.47.0) · source

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

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

Examples

基本用法：

assert_eq!(1u128.checked_sub(1), Some(0));
assert_eq!(0u128.checked_sub(1), None);

Run

const: unstable · source

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

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

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

Safety

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

1.0.0 (const: 1.47.0) · source

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

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

Examples

基本用法：

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

Run

const: unstable · source

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

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

基本用法：

assert_eq!(5u128.checked_rem_euclid(2), Some(1));
assert_eq!(5u128.checked_rem_euclid(0), None);

Run

1.67.0 (const: 1.67.0) · source

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

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

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

Panics

如果 self 为零，或者如果 base 小于 2.

Examples

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

Run

1.67.0 (const: 1.67.0) · source

pub const fn ilog2(self) -> u32

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

Panics

如果 self 为零，这个函数将会 panic。

Examples

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

Run

1.67.0 (const: 1.67.0) · source

pub const fn ilog10(self) -> u32

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

Panics

如果 self 为零，这个函数将会 panic。

Example

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

Run

1.67.0 (const: 1.67.0) · source

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

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

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

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

Examples

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

Run

1.67.0 (const: 1.67.0) · source

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

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

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

Examples

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

Run

1.67.0 (const: 1.67.0) · source

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

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

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

Examples

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

Run

1.7.0 (const: 1.47.0) · source

pub const fn checked_neg(self) -> Option<u128>

检查否定。计算 -self，除非 self == 0，否则返回 None。

请注意，取反任何正整数将溢出。

Examples

基本用法：

assert_eq!(0u128.checked_neg(), Some(0));
assert_eq!(1u128.checked_neg(), None);

Run

1.7.0 (const: 1.47.0) · source

pub const fn checked_shl(self, rhs: u32) -> Option<u128>

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

Examples

基本用法：

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

Run

const: unstable · source

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

🔬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<u128>

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

Examples

基本用法：

assert_eq!(0x10u128.checked_shr(4), Some(0x1));
assert_eq!(0x10u128.checked_shr(129), None);

Run

const: unstable · source

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

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

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

Safety

assert_eq!(5u128.saturating_div(2), 2);

Run

let _ = 1u128.saturating_div(0);

Run

1.34.0 (const: 1.50.0) · source

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

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

Examples

基本用法：

assert_eq!(4u128.saturating_pow(3), 64);
assert_eq!(u128::MAX.saturating_pow(2), u128::MAX);

Run

1.0.0 (const: 1.32.0) · source

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

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

Examples

基本用法：

assert_eq!(200u128.wrapping_add(55), 255);
assert_eq!(200u128.wrapping_add(u128::MAX), 199);

Run

1.66.0 (const: 1.66.0) · source

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

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

Examples

基本用法：

assert_eq!(1u128.wrapping_add_signed(2), 3);
assert_eq!(1u128.wrapping_add_signed(-2), u128::MAX);
assert_eq!((u128::MAX - 2).wrapping_add_signed(4), 1);

Run

1.0.0 (const: 1.32.0) · source

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

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

Examples

基本用法：

assert_eq!(100u128.wrapping_sub(100), 0);
assert_eq!(100u128.wrapping_sub(u128::MAX), 101);

Run

1.0.0 (const: 1.32.0) · source

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

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

Examples

基本用法：

请注意，此示例在整数类型之间共享。这就解释了为什么在这里使用 u8。

assert_eq!(10u8.wrapping_mul(12), 120);
assert_eq!(25u8.wrapping_mul(12), 44);

Run

1.2.0 (const: 1.52.0) · source

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

包装 (modular) 分区。计算 self / rhs。无符号类型的包装除法只是普通除法。包装是不可能发生的。该函数存在，因此所有操作都在包装操作中考虑。

Examples

基本用法：

assert_eq!(100u128.wrapping_div(10), 10);

Run

1.38.0 (const: 1.52.0) · source

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

包装欧几里得除法。计算 self.div_euclid(rhs)。无符号类型的包装除法只是普通除法。包装是不可能发生的。该函数存在，因此所有操作都在包装操作中考虑。因为对于正整数，所有除法的通用定义都是相等的，所以它恰好等于 self.wrapping_div(rhs)。

Examples

基本用法：

assert_eq!(100u128.wrapping_div_euclid(10), 10);

Run

1.2.0 (const: 1.52.0) · source

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

包装 (modular) 余数。计算 self % rhs。无符号类型的包装余数计算只是常规余数计算。

包装是不可能发生的。该函数存在，因此所有操作都在包装操作中考虑。

Examples

基本用法：

assert_eq!(100u128.wrapping_rem(10), 0);

Run

1.38.0 (const: 1.52.0) · source

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

包装欧几里德模。计算 self.rem_euclid(rhs)。无符号类型的包装模运算只是常规的余数计算。包装是不可能发生的。该函数存在，因此所有操作都在包装操作中考虑。因为对于正整数，所有除法的通用定义都是相等的，所以它恰好等于 self.wrapping_rem(rhs)。

Examples

基本用法：

assert_eq!(100u128.wrapping_rem_euclid(10), 0);

Run

1.2.0 (const: 1.32.0) · source

pub const fn wrapping_neg(self) -> u128

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

由于无符号类型没有负的等效项，因此该函数的所有应用程序都将自动换行 (-0 除外)。对于小于相应有符号类型的最大值的值，结果与强制转换相应有符号值的结果相同。

任何较大的值都等于 MAX + 1 - (val - MAX - 1)，其中 MAX 是对应的有符号类型的最大值。

Examples

基本用法：

assert_eq!(0_u128.wrapping_neg(), 0);
assert_eq!(u128::MAX.wrapping_neg(), 1);
assert_eq!(13_u128.wrapping_neg(), (!13) + 1);
assert_eq!(42_u128.wrapping_neg(), !(42 - 1));

Run

1.2.0 (const: 1.32.0) · source

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

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

注意，这与左旋不同；环绕左移的 RHS 限于该类型的范围，而不是从 LHS 移出的位返回到另一端。所有原始整数类型都实现了 rotate_left 函数，而您可能想要的是 rotate_left 函数。

Examples

基本用法：

assert_eq!(1u128.wrapping_shl(7), 128);
assert_eq!(1u128.wrapping_shl(128), 1);

Run

1.2.0 (const: 1.32.0) · source

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

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

注意，这与右旋转不同。换行右移的 RHS 限于类型的范围，而不是从 LHS 移出的位返回到另一端。所有原始整数类型都实现了 rotate_right 函数，而您可能想要的是 rotate_right 函数。

Examples

基本用法：

assert_eq!(128u128.wrapping_shr(7), 1);
assert_eq!(128u128.wrapping_shr(128), 128);

Run

1.34.0 (const: 1.50.0) · source

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

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

Examples

基本用法：

assert_eq!(3u128.wrapping_pow(5), 243);
assert_eq!(3u8.wrapping_pow(6), 217);

Run

1.7.0 (const: 1.32.0) · source

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

计算 self + rhs

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

Examples

基本用法

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

Run

const: unstable · source

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

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

计算 self + rhs + carry 并返回一个包含总和和输出进位的元组。

对两个整数操作数和一个进位位执行 “ternary addition”，并返回一个输出整数和一个进位位。这允许将多个加法链接在一起以创建更广泛的加法，并且对于 bignum 加法很有用。

This can be thought of as a 128-bit “full adder”, in the electronics sense. 如果输入进位为假，则此方法等价于 overflowing_add，输出进位等于溢出标志。请注意，尽管进位和溢出标志对于无符号整数是相似的，但对于有符号整数它们是不同的。

Examples

#![feature(bigint_helper_methods)]

//    3  MAX    (a = 3 × 2^128 + 2^128 - 1)
// +  5    7    (b = 5 × 2^128 + 7)
// ---------
//    9    6    (sum = 9 × 2^128 + 6)

let (a1, a0): (u128, u128) = (3, u128::MAX);
let (b1, b0): (u128, u128) = (5, 7);
let carry0 = false;

let (sum0, carry1) = a0.carrying_add(b0, carry0);
assert_eq!(carry1, true);
let (sum1, carry2) = a1.carrying_add(b1, carry1);
assert_eq!(carry2, false);

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

Run

1.66.0 (const: 1.66.0) · source

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

使用带符号的 rhs 计算 self + rhs

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

Examples

基本用法：

assert_eq!(1u128.overflowing_add_signed(2), (3, false));
assert_eq!(1u128.overflowing_add_signed(-2), (u128::MAX, true));
assert_eq!((u128::MAX - 2).overflowing_add_signed(4), (1, true));

Run

1.7.0 (const: 1.32.0) · source

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

计算 self-rhs

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

Examples

基本用法

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

Run

const: unstable · source

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

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

计算 self-rhs-borrow 并返回一个包含差值和输出借用的元组。

通过从 self 中减去一个整数操作数和一个借用 - in 位来执行 “ternary subtraction”，并返回一个输出整数和一个借用 - out 位。这允许将多个减法链接在一起以创建更广泛的减法，并且对于 bignum 减法很有用。

Examples

#![feature(bigint_helper_methods)]

//    9    6    (a = 9 × 2^128 + 6)
// -  5    7    (b = 5 × 2^128 + 7)
// ---------
//    3  MAX    (diff = 3 × 2^128 + 2^128 - 1)

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

let (diff0, borrow1) = a0.borrowing_sub(b0, borrow0);
assert_eq!(borrow1, true);
let (diff1, borrow2) = a1.borrowing_sub(b1, borrow1);
assert_eq!(borrow2, false);

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

Run

1.60.0 (const: 1.60.0) · source

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

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

Examples

基本用法：

assert_eq!(100u128.abs_diff(80), 20u128);
assert_eq!(100u128.abs_diff(110), 10u128);

Run

1.7.0 (const: 1.32.0) · source

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

计算 self 和 rhs 的乘法。

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

Examples

基本用法：

请注意，此示例在整数类型之间共享。这就解释了为什么在这里使用 u32。

assert_eq!(5u32.overflowing_mul(2), (10, false));
assert_eq!(1_000_000_000u32.overflowing_mul(10), (1410065408, true));

Run

1.7.0 (const: 1.52.0) · source

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

self 除以 rhs 时计算除数。

返回除数的元组以及指示是否将发生算术溢出的布尔值。请注意，对于无符号整数，永远不会发生溢出，因此第二个值始终为 false。

Panics

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

Examples

基本用法

assert_eq!(5u128.overflowing_div(2), (2, false));

Run

1.38.0 (const: 1.52.0) · source

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

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

返回除数的元组以及指示是否将发生算术溢出的布尔值。请注意，对于无符号整数，永远不会发生溢出，因此第二个值始终为 false。因为对于正整数，所有除法的通用定义都是相等的，所以它恰好等于 self.overflowing_div(rhs)。

Panics

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

Examples

基本用法

assert_eq!(5u128.overflowing_div_euclid(2), (2, false));

Run

1.7.0 (const: 1.52.0) · source

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

self 除以 rhs 时计算余数。

返回除法运算后的余数元组和一个布尔值，该布尔值指示是否会发生算术溢出。请注意，对于无符号整数，永远不会发生溢出，因此第二个值始终为 false。

Panics

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

Examples

基本用法

assert_eq!(5u128.overflowing_rem(2), (1, false));

Run

1.38.0 (const: 1.52.0) · source

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

以欧几里得除法计算余数 self.rem_euclid(rhs)。

返回除以布尔后的模元，并返回一个布尔值，指示是否会发生算术溢出。请注意，对于无符号整数，永远不会发生溢出，因此第二个值始终为 false。由于对于正整数，所有除法的通用定义均相等，因此该运算恰好等于 self.overflowing_rem(rhs)。

Panics

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

Examples

基本用法

assert_eq!(5u128.overflowing_rem_euclid(2), (1, false));

Run

1.7.0 (const: 1.32.0) · source

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

以一种泛滥的方式否定自我。

使用包装操作返回 !self + 1，以返回表示该无符号值的取反的值。请注意，对于正的无符号值，总是会发生溢出，但取反 0 不会溢出。

Examples

基本用法

assert_eq!(0u128.overflowing_neg(), (0, false));
assert_eq!(2u128.overflowing_neg(), (-2i32 as u128, true));

Run

1.7.0 (const: 1.32.0) · source

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

将 self 左移 rhs 位。

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

Examples

基本用法

assert_eq!(0x1u128.overflowing_shl(4), (0x10, false));
assert_eq!(0x1u128.overflowing_shl(132), (0x10, true));

Run

1.7.0 (const: 1.32.0) · source

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

将 self 右移 rhs 位。

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

Examples

基本用法

assert_eq!(0x10u128.overflowing_shr(4), (0x1, false));
assert_eq!(0x10u128.overflowing_shr(132), (0x1, true));

Run

1.34.0 (const: 1.50.0) · source

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

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

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

Examples

基本用法：

assert_eq!(3u128.overflowing_pow(5), (243, false));
assert_eq!(3u8.overflowing_pow(6), (217, true));

Run

1.0.0 (const: 1.50.0) · source

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

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

Examples

基本用法：

assert_eq!(2u128.pow(5), 32);

Run

1.38.0 (const: 1.52.0) · source

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

执行欧几里得除法。

因为对于正整数，所有除法的通用定义都是相等的，所以它恰好等于 self / rhs。

Panics

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

Examples

基本用法：

assert_eq!(7u128.div_euclid(4), 1); // or any other integer type

Run

1.38.0 (const: 1.52.0) · source

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

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

因为对于正整数，所有除法的通用定义都是相等的，所以它恰好等于 self % rhs。

Panics

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

Examples

基本用法：

assert_eq!(7u128.rem_euclid(4), 3); // or any other integer type

Run

source

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

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

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

这与对所有无符号整数执行 self / rhs 相同。

Panics

如果 rhs 为零，这个函数将会 panic。

Examples

基本用法：

#![feature(int_roundings)]
assert_eq!(7_u128.div_floor(4), 1);

Run

source

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

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

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

#![feature(int_roundings)]
assert_eq!(7_u128.div_ceil(4), 2);

Run

source

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

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

计算大于或等于 rhs 倍数的 self 的最小值。

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

Run

source

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

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

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

Examples

基本用法：

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

Run

1.0.0 (const: 1.32.0) · source

pub const fn is_power_of_two(self) -> bool

当且仅当某些 k 的 self == 2^k 时，才返回 true。

Examples

基本用法：

assert!(16u128.is_power_of_two());
assert!(!10u128.is_power_of_two());

Run

1.0.0 (const: 1.50.0) · source

pub const fn next_power_of_two(self) -> u128

返回大于或等于 self 的 2 的最小幂。

当返回值溢出 (即 uN 类型为 self > (1 << (N-1))) 时，它在调试模式下为 panics，在生产模式下返回值被包装为 0 (方法可以返回 0 的唯一情况)。

Examples

基本用法：

assert_eq!(2u128.next_power_of_two(), 2);
assert_eq!(3u128.next_power_of_two(), 4);

Run

1.0.0 (const: 1.50.0) · source

pub const fn checked_next_power_of_two(self) -> Option<u128>

返回大于或等于 n 的 2 的最小幂。如果下一个 2 的幂大于该类型的最大值，则返回 None，否则将 2 的幂包装在 Some 中。

Examples

基本用法：

assert_eq!(2u128.checked_next_power_of_two(), Some(2));
assert_eq!(3u128.checked_next_power_of_two(), Some(4));
assert_eq!(u128::MAX.checked_next_power_of_two(), None);

Run

const: unstable · source

pub fn wrapping_next_power_of_two(self) -> u128

🔬This is a nightly-only experimental API. (wrapping_next_power_of_two #32463)

返回大于或等于 n 的 2 的最小幂。如果下一个 2 的幂大于该类型的最大值，则返回值将包装为 0。

Examples

基本用法：

#![feature(wrapping_next_power_of_two)]

assert_eq!(2u128.wrapping_next_power_of_two(), 2);
assert_eq!(3u128.wrapping_next_power_of_two(), 4);
assert_eq!(u128::MAX.wrapping_next_power_of_two(), 0);

Run

1.32.0 (const: 1.44.0) · source

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

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

Examples

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

Run

1.32.0 (const: 1.44.0) · source

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

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

Examples

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

Run

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 = 0x12345678901234567890123456789012u128.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

1.32.0 (const: 1.44.0) · source

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

根据其表示形式 (大字节序中的字节数组) 创建一个本地字节序整数值。

Examples

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

Run

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

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

Run

1.32.0 (const: 1.44.0) · source

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

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

Examples

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

Run

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

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

Run

1.32.0 (const: 1.44.0) · source

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

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

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

Examples

let value = u128::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

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

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

Run

1.0.0 (const: 1.32.0) · source

pub const fn min_value() -> u128

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

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

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

1.0.0 (const: 1.32.0) · source

pub const fn max_value() -> u128

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

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

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

const: unstable · source

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

🔬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!(0u128.midpoint(4), 2);
assert_eq!(1u128.midpoint(4), 2);

Run

This operation will panic if other == 0.

§

type Output = u128

应用 / 运算符后的结果类型。

source §

fn from(ip: Ipv6Addr) -> u128

将 Ipv6Addr 转换为主机字节顺序 u128。

Examples

use std::net::Ipv6Addr;

let addr = Ipv6Addr::new(
    0x1020, 0x3040, 0x5060, 0x7080,
    0x90A0, 0xB0C0, 0xD0E0, 0xF00D,
);
assert_eq!(0x102030405060708090A0B0C0D0E0F00D_u128, u128::from(addr));

Run

1.31.0 · source§

impl From<NonZeroU128> for u128

source §

use std::net::Ipv6Addr;

let addr = Ipv6Addr::from(0x102030405060708090A0B0C0D0E0F00D_u128);
assert_eq!(
    Ipv6Addr::new(
        0x1020, 0x3040, 0x5060, 0x7080,
        0x90A0, 0xB0C0, 0xD0E0, 0xF00D,
    ),
    addr);