Struct core::num::NonZeroIsize1.34.0[−][src]

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

已知不等于零的整数。

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

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

Implementations

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

Safety

该值不能为零。

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

将值作为原始类型返回。

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

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

Examples

基本用法：

let n = std::num::NonZeroIsize::new(-1isize).unwrap();

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

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

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

Examples

基本用法：

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

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

计算 self 的绝对值。 See isize::abs 有关溢出行为的文档。

Example
#![feature(nonzero_ops)]

let pos = NonZeroIsize::new(1)?;
let neg = NonZeroIsize::new(-1)?;

assert_eq!(pos, pos.abs());
assert_eq!(pos, neg.abs());
Run
🔬 This is a nightly-only experimental API. (nonzero_ops #84186)

检查的绝对值。 检查溢出并返回 None 如果 self == isize::MIN. 结果不能为零。

Example
#![feature(nonzero_ops)]

let pos = NonZeroIsize::new(1)?;
let neg = NonZeroIsize::new(-1)?;
let min = NonZeroIsize::new(isize::MIN)?;

assert_eq!(Some(pos), neg.checked_abs());
assert_eq!(None, min.checked_abs());
Run
🔬 This is a nightly-only experimental API. (nonzero_ops #84186)

计算 self 的绝对值，带有溢出信息，请参见

isize::overflowing_abs.

Example
#![feature(nonzero_ops)]

let pos = NonZeroIsize::new(1)?;
let neg = NonZeroIsize::new(-1)?;
let min = NonZeroIsize::new(isize::MIN)?;

assert_eq!((pos, false), pos.overflowing_abs());
assert_eq!((pos, false), neg.overflowing_abs());
assert_eq!((min, true), min.overflowing_abs());
Run
🔬 This is a nightly-only experimental API. (nonzero_ops #84186)

饱和绝对值，请参见 isize::saturating_abs.

Example
#![feature(nonzero_ops)]

let pos = NonZeroIsize::new(1)?;
let neg = NonZeroIsize::new(-1)?;
let min = NonZeroIsize::new(isize::MIN)?;
let min_plus = NonZeroIsize::new(isize::MIN + 1)?;
let max = NonZeroIsize::new(isize::MAX)?;

assert_eq!(pos, pos.saturating_abs());
assert_eq!(pos, neg.saturating_abs());
assert_eq!(max, min.saturating_abs());
assert_eq!(max, min_plus.saturating_abs());
Run
🔬 This is a nightly-only experimental API. (nonzero_ops #84186)

包装绝对值，请参见 isize::wrapping_abs.

Example
#![feature(nonzero_ops)]

let pos = NonZeroIsize::new(1)?;
let neg = NonZeroIsize::new(-1)?;
let min = NonZeroIsize::new(isize::MIN)?;
let max = NonZeroIsize::new(isize::MAX)?;

assert_eq!(pos, pos.wrapping_abs());
assert_eq!(pos, neg.wrapping_abs());
assert_eq!(min, min.wrapping_abs());
Run
🔬 This is a nightly-only experimental API. (nonzero_ops #84186)

在没有任何包装或 panicking 的情况下计算 self 的绝对值。

Example
#![feature(nonzero_ops)]


let u_pos = NonZeroUsize::new(1)?;
let i_pos = NonZeroIsize::new(1)?;
let i_neg = NonZeroIsize::new(-1)?;
let i_min = NonZeroIsize::new(isize::MIN)?;
let u_max = NonZeroUsize::new(usize::MAX / 2 + 1)?;

assert_eq!(u_pos, i_pos.unsigned_abs());
assert_eq!(u_pos, i_neg.unsigned_abs());
assert_eq!(u_max, i_min.unsigned_abs());
Run
🔬 This is a nightly-only experimental API. (nonzero_ops #84186)

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

Examples
#![feature(nonzero_ops)]

let two = NonZeroIsize::new(2)?;
let four = NonZeroIsize::new(4)?;
let max = NonZeroIsize::new(isize::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 isize::MAX on overflow.

Examples
#![feature(nonzero_ops)]

let two = NonZeroIsize::new(2)?;
let four = NonZeroIsize::new(4)?;
let max = NonZeroIsize::new(isize::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 > isize::MAX, or self * rhs < isize::MIN.

Examples
#![feature(nonzero_ops)]

let two = NonZeroIsize::new(2)?;
let four = NonZeroIsize::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 = NonZeroIsize::new(3)?;
let twenty_seven = NonZeroIsize::new(27)?;
let half_max = NonZeroIsize::new(isize::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 isize::MIN or isize::MAX on overflow.

Examples
#![feature(nonzero_ops)]

let three = NonZeroIsize::new(3)?;
let twenty_seven = NonZeroIsize::new(27)?;
let max = NonZeroIsize::new(isize::MAX)?;

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

Trait Implementations

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

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

执行 | 操作。 Read more

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

执行 | 操作。 Read more

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

执行 | 操作。 Read more

执行 |= 操作。 Read more

执行 |= 操作。 Read more

返回值的副本。 Read more

从 source 执行复制分配。 Read more

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

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

Converts NonZeroI16 to NonZeroIsize losslessly.

Converts NonZeroI8 to NonZeroIsize losslessly.

Converts a NonZeroIsize into an isize

Converts NonZeroU8 to NonZeroIsize 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

Attempts to convert NonZeroI128 to NonZeroIsize.

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

Attempts to convert NonZeroI32 to NonZeroIsize.

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

Attempts to convert NonZeroI64 to NonZeroIsize.

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

Attempts to convert NonZeroIsize to NonZeroU8.

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

Attempts to convert NonZeroIsize to NonZeroU16.

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

Attempts to convert NonZeroIsize to NonZeroI128.

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

Attempts to convert NonZeroIsize to NonZeroU32.

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

Attempts to convert NonZeroIsize to NonZeroU64.

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

Attempts to convert NonZeroIsize to NonZeroU128.

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

Attempts to convert NonZeroIsize to NonZeroUsize.

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

Attempts to convert NonZeroIsize to NonZeroI8.

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

Attempts to convert NonZeroIsize to NonZeroI16.

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

Attempts to convert NonZeroIsize to NonZeroI32.

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

Attempts to convert NonZeroIsize to NonZeroI64.

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

Attempts to convert NonZeroU128 to NonZeroIsize.

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

Attempts to convert NonZeroU16 to NonZeroIsize.

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

Attempts to convert NonZeroU32 to NonZeroIsize.

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

Attempts to convert NonZeroU64 to NonZeroIsize.

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

Attempts to convert NonZeroUsize to NonZeroIsize.

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

Attempts to convert isize to NonZeroIsize.

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

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

Auto Trait Implementations

Blanket Implementations

获取 self 的 TypeId。 Read more

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

从拥有的值中借用。 Read more

执行转换。

执行转换。

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

执行转换。

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

执行转换。