Struct std::num::NonZeroU1281.28.0[−][src]

#[repr(transparent)]
pub struct NonZeroU128(_);
Expand description

已知不等于零的整数。

这样可以进行一些内存布局优化。 For example, Option<NonZeroU128> is the same size as u128:

use std::mem::size_of;
assert_eq!(size_of::<Option<core::num::NonZeroU128>>(), size_of::<u128>());
Run

Implementations

创建一个非零值而不检查该值是否为非零值。 如果该值为零，这将导致未定义的行为。

Safety

该值不能为零。

如果给定值不为零，则创建一个非零值。

将值作为原始类型返回。

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

在许多体系结构上，此函数在底层整数类型上的性能优于 leading_zeros()，因为可以避免对零的特殊处理。

Examples

基本用法：

let n = std::num::NonZeroU128::new(u128::MAX).unwrap();

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

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

在许多体系结构上，此函数在底层整数类型上的性能优于 trailing_zeros()，因为可以避免对零的特殊处理。

Examples

基本用法：

let n = std::num::NonZeroU128::new(0b0101000).unwrap();

assert_eq!(n.trailing_zeros(), 3);
Run
🔬 This is a nightly-only experimental API. (nonzero_ops #84186)

将无符号整数添加到非零值。 检查溢出并在溢出时返回 None 因此，结果不能归零。

Examples
#![feature(nonzero_ops)]


let one = NonZeroU128::new(1)?;
let two = NonZeroU128::new(2)?;
let max = NonZeroU128::new(u128::MAX)?;

assert_eq!(Some(two), one.checked_add(1));
assert_eq!(None, max.checked_add(1));
Run
🔬 This is a nightly-only experimental API. (nonzero_ops #84186)

将无符号整数添加到非零值。 Return u128::MAX on overflow.

Examples
#![feature(nonzero_ops)]

let one = NonZeroU128::new(1)?;
let two = NonZeroU128::new(2)?;
let max = NonZeroU128::new(u128::MAX)?;

assert_eq!(two, one.saturating_add(1));
assert_eq!(max, max.saturating_add(1));
Run
🔬 This is a nightly-only experimental API. (nonzero_ops #84186)

假设不会发生溢出，将无符号整数添加到非零值。 溢出未检查，如果结果将换行为非零值，则溢出 *even 是未定义的行为 *。

该行为是未定义的

self + rhs > u128::MAX.

Examples
#![feature(nonzero_ops)]

let one = NonZeroU128::new(1)?;
let two = NonZeroU128::new(2)?;

assert_eq!(two, unsafe { one.unchecked_add(1) });
Run
🔬 This is a nightly-only experimental API. (nonzero_ops #84186)

返回大于或等于 n 的 2 的最小幂。 如果下一个 2 的幂大于类型的最大值，则检查是否溢出并返回 None。 因此，结果不能归零。

Examples
#![feature(nonzero_ops)]


let two = NonZeroU128::new(2)?;
let three = NonZeroU128::new(3)?;
let four = NonZeroU128::new(4)?;
let max = NonZeroU128::new(u128::MAX)?;

assert_eq!(Some(two), two.checked_next_power_of_two() );
assert_eq!(Some(four), three.checked_next_power_of_two() );
assert_eq!(None, max.checked_next_power_of_two() );
Run
🔬 This is a nightly-only experimental API. (nonzero_ops #84186)

将两个非零整数相乘。 检查溢出并在溢出时返回 None。 因此，结果不能归零。

Examples
#![feature(nonzero_ops)]

let two = NonZeroU128::new(2)?;
let four = NonZeroU128::new(4)?;
let max = NonZeroU128::new(u128::MAX)?;

assert_eq!(Some(four), two.checked_mul(two));
assert_eq!(None, max.checked_mul(two));
Run
🔬 This is a nightly-only experimental API. (nonzero_ops #84186)

将两个非零整数相乘。 Return u128::MAX on overflow.

Examples
#![feature(nonzero_ops)]

let two = NonZeroU128::new(2)?;
let four = NonZeroU128::new(4)?;
let max = NonZeroU128::new(u128::MAX)?;

assert_eq!(four, two.saturating_mul(two));
assert_eq!(max, four.saturating_mul(max));
Run
🔬 This is a nightly-only experimental API. (nonzero_ops #84186)

假设不会发生溢出，将两个非零整数相乘。 溢出未检查，如果结果将换行为非零值，则溢出 *even 是未定义的行为 *。

该行为是未定义的

self * rhs > u128::MAX.

Examples
#![feature(nonzero_ops)]

let two = NonZeroU128::new(2)?;
let four = NonZeroU128::new(4)?;

assert_eq!(four, unsafe { two.unchecked_mul(two) });
Run
🔬 This is a nightly-only experimental API. (nonzero_ops #84186)

将非零值提高到整数幂。 检查溢出并在溢出时返回 None。 因此，结果不能归零。

Examples
#![feature(nonzero_ops)]

let three = NonZeroU128::new(3)?;
let twenty_seven = NonZeroU128::new(27)?;
let half_max = NonZeroU128::new(u128::MAX / 2)?;

assert_eq!(Some(twenty_seven), three.checked_pow(3));
assert_eq!(None, half_max.checked_pow(3));
Run
🔬 This is a nightly-only experimental API. (nonzero_ops #84186)

将非零值提高到整数幂。 Return u128::MAX on overflow.

Examples
#![feature(nonzero_ops)]

let three = NonZeroU128::new(3)?;
let twenty_seven = NonZeroU128::new(27)?;
let max = NonZeroU128::new(u128::MAX)?;

assert_eq!(twenty_seven, three.saturating_pow(3));
assert_eq!(max, max.saturating_pow(3));
Run

当且仅当某些 k 的 self == (1 << k) 时，才返回 true。

在许多体系结构上，此函数在底层整数类型上的性能优于 is_power_of_two()，因为可以避免对零的特殊处理。

Examples

基本用法：

let eight = std::num::NonZeroU128::new(8).unwrap();
assert!(eight.is_power_of_two());
let ten = std::num::NonZeroU128::new(10).unwrap();
assert!(!ten.is_power_of_two());
Run

Trait Implementations

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

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

执行 | 操作。 Read more

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

执行 | 操作。 Read more

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

执行 | 操作。 Read more

执行 |= 操作。 Read more

执行 |= 操作。 Read more

返回值的副本。 Read more

从 source 执行复制分配。 Read more

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

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

此运算将舍入为零，舍去精确结果的任何小数部分，并且不能为 panic。

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

Converts a NonZeroU128 into an u128

Converts NonZeroU16 to NonZeroU128 losslessly.

Converts NonZeroU32 to NonZeroU128 losslessly.

Converts NonZeroU64 to NonZeroU128 losslessly.

Converts NonZeroU8 to NonZeroU128 losslessly.

可以从解析中返回的相关错误。

解析字符串 s 以返回此类型的值。 Read more

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

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

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

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

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

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

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

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

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

此方法测试 !=。

如果存在，则此方法返回 self 和 other 值之间的顺序。 Read more

此方法测试的内容少于 (对于 self 和 other)，并且由 < 操作员使用。 Read more

此方法测试小于或等于 (对于 self 和 other)，并且由 <= 运算符使用。 Read more

此方法测试大于 (对于 self 和 other)，并且由 > 操作员使用。 Read more

此方法测试是否大于或等于 (对于 self 和 other)，并且由 >= 运算符使用。 Read more

此操作满足 n % d == n - (n / d) * d，但不能为 panic。

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

Attempts to convert NonZeroI128 to NonZeroU128.

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

Attempts to convert NonZeroI16 to NonZeroU128.

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

Attempts to convert NonZeroI32 to NonZeroU128.

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

Attempts to convert NonZeroI64 to NonZeroU128.

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

Attempts to convert NonZeroI8 to NonZeroU128.

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

Attempts to convert NonZeroIsize to NonZeroU128.

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

Attempts to convert NonZeroU128 to NonZeroU64.

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

Attempts to convert NonZeroU128 to NonZeroI128.

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

Attempts to convert NonZeroU128 to NonZeroIsize.

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

Attempts to convert NonZeroU128 to NonZeroI8.

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

Attempts to convert NonZeroU128 to NonZeroU32.

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

Attempts to convert NonZeroU128 to NonZeroUsize.

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

Attempts to convert NonZeroU128 to NonZeroI32.

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

Attempts to convert NonZeroU128 to NonZeroI16.

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

Attempts to convert NonZeroU128 to NonZeroI64.

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

Attempts to convert NonZeroU128 to NonZeroU16.

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

Attempts to convert NonZeroU128 to NonZeroU8.

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

Attempts to convert NonZeroUsize to NonZeroU128.

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

Attempts to convert u128 to NonZeroU128.

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

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

Auto Trait Implementations

Blanket Implementations

获取 self 的 TypeId。 Read more

从拥有的值中一成不变地借用。 Read more

从拥有的值中借用。 Read more

执行转换。

执行转换。

获得所有权后的结果类型。

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

🔬 This is a nightly-only experimental API. (toowned_clone_into #41263)

使用借来的数据来替换拥有的数据，通常是通过克隆。 Read more

将给定值转换为 String。 Read more

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

执行转换。

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

执行转换。