Primitive Type u8 <img src="../static.files/clipboard-7571035ce49a181d.svg" width="19" height="18" alt="Copy item path">

impl u8

1.43.0 · source

pub const MIN: Self = 0u8

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

Examples

基本用法：

assert_eq!(u8::MIN, 0);

1.43.0 · source

pub const MAX: Self = 255u8

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

Examples

基本用法：

assert_eq!(u8::MAX, 255);

1.53.0 · source

pub const BITS: u32 = 8u32

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

Examples

assert_eq!(u8::BITS, 8);

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

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

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

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

0-9
a-z
A-Z

Panics

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

Examples

基本用法：

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

const: 1.32.0 · source

pub const fn count_ones(self) -> u32

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

Examples

基本用法：

let n = 0b01001100u8;

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

const: 1.32.0 · source

pub const fn count_zeros(self) -> u32

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

Examples

基本用法：

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

const: 1.32.0 · source

pub const fn leading_zeros(self) -> u32

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

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

Examples

基本用法：

let n = u8::MAX >> 2;

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

const: 1.32.0 · source

pub const fn trailing_zeros(self) -> u32

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

Examples

基本用法：

let n = 0b0101000u8;

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

1.46.0 (const: 1.46.0) · source

pub const fn leading_ones(self) -> u32

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

Examples

基本用法：

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

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

1.46.0 (const: 1.46.0) · source

pub const fn trailing_ones(self) -> u32

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

Examples

基本用法：

let n = 0b1010111u8;

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

const: 1.32.0 · source

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

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

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

Examples

基本用法：

let n = 0x82u8;
let m = 0xa;

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

const: 1.32.0 · source

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

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

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

Examples

基本用法：

let n = 0xau8;
let m = 0x82;

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

const: 1.32.0 · source

pub const fn swap_bytes(self) -> Self

反转整数的字节顺序。

Examples

基本用法：

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

assert_eq!(m, 0x12);

1.37.0 (const: 1.37.0) · source

pub const fn reverse_bits(self) -> Self

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

Examples

基本用法：

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

assert_eq!(m, 0x48);
assert_eq!(0, 0u8.reverse_bits());

const: 1.32.0 · source

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

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

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

Examples

基本用法：

let n = 0x1Au8;

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

const: 1.32.0 · source

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

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

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

Examples

基本用法：

let n = 0x1Au8;

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

const: 1.32.0 · source

pub const fn to_be(self) -> Self

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

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

Examples

基本用法：

let n = 0x1Au8;

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

const: 1.32.0 · source

pub const fn to_le(self) -> Self

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

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

Examples

基本用法：

let n = 0x1Au8;

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

const: 1.47.0 · source

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

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

Examples

基本用法：

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

const: unstable · source

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

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

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

Safety

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

1.66.0 (const: 1.66.0) · source

pub const fn checked_add_signed(self, rhs: i8) -> Option<Self>

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

Examples

基本用法：

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

const: 1.47.0 · source

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

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

Examples

基本用法：

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

const: unstable · source

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

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

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

Safety

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

const: 1.47.0 · source

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

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

Examples

基本用法：

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

const: unstable · source

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

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

基本用法：

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

1.67.0 (const: 1.67.0) · source

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

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

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

Panics

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

Examples

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

1.67.0 (const: 1.67.0) · source

pub const fn ilog2(self) -> u32

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

Panics

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

Examples

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

1.67.0 (const: 1.67.0) · source

pub const fn ilog10(self) -> u32

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

Panics

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

Example

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

1.67.0 (const: 1.67.0) · source

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

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

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

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

Examples

assert_eq!(5u8.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!(2u8.checked_ilog2(), Some(1));

1.67.0 (const: 1.67.0) · source

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

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

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

Examples

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

1.7.0 (const: 1.47.0) · source

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

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

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

Examples

基本用法：

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

1.7.0 (const: 1.47.0) · source

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

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

Examples

基本用法：

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

const: unstable · source

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

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

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

Examples

基本用法：

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

const: unstable · source

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

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

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

Safety

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

let _ = 1u8.saturating_div(0);

1.34.0 (const: 1.50.0) · source

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

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

Examples

基本用法：

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

const: 1.32.0 · source

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

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

Examples

基本用法：

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

1.66.0 (const: 1.66.0) · source

pub const fn wrapping_add_signed(self, rhs: i8) -> Self

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

Examples

基本用法：

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

const: 1.32.0 · source

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

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

Examples

基本用法：

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

const: 1.32.0 · source

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

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

Examples

基本用法：

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

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

1.2.0 (const: 1.52.0) · source

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

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

Examples

基本用法：

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

1.38.0 (const: 1.52.0) · source

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

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

Examples

基本用法：

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

1.2.0 (const: 1.52.0) · source

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

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

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

Examples

基本用法：

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

1.38.0 (const: 1.52.0) · source

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

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

Examples

基本用法：

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

1.2.0 (const: 1.32.0) · source

pub const fn wrapping_neg(self) -> Self

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

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

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

Examples

基本用法：

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

1.2.0 (const: 1.32.0) · source

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

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

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

Examples

基本用法：

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

1.2.0 (const: 1.32.0) · source

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

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

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

Examples

基本用法：

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

1.34.0 (const: 1.50.0) · source

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

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

Examples

基本用法：

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

1.7.0 (const: 1.32.0) · source

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

计算 self + rhs

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

Examples

基本用法

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

const: unstable · source

pub fn carrying_add(self, rhs: Self, carry: bool) -> (Self, 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 8-bit “full adder”, in the electronics sense. 如果输入进位为假，则此方法等价于 overflowing_add，输出进位等于溢出标志。请注意，尽管进位和溢出标志对于无符号整数是相似的，但对于有符号整数它们是不同的。

Examples

#![feature(bigint_helper_methods)]

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

let (a1, a0): (u8, u8) = (3, u8::MAX);
let (b1, b0): (u8, u8) = (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));

1.66.0 (const: 1.66.0) · source

pub const fn overflowing_add_signed(self, rhs: i8) -> (Self, bool)

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

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

Examples

基本用法：

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

1.7.0 (const: 1.32.0) · source

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

计算 self-rhs

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

Examples

基本用法

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

const: unstable · source

pub fn borrowing_sub(self, rhs: Self, borrow: bool) -> (Self, 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^8 + 6)
// -  5    7    (b = 5 × 2^8 + 7)
// ---------
//    3  MAX    (diff = 3 × 2^8 + 2^8 - 1)

let (a1, a0): (u8, u8) = (9, 6);
let (b1, b0): (u8, u8) = (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, u8::MAX));

1.60.0 (const: 1.60.0) · source

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

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

Examples

基本用法：

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

1.7.0 (const: 1.32.0) · source

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

计算 self 和 rhs 的乘法。

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

Examples

基本用法：

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

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

1.7.0 (const: 1.52.0) · source

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

self 除以 rhs 时计算除数。

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

Panics

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

Examples

基本用法

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

1.38.0 (const: 1.52.0) · source

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

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

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

Panics

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

Examples

基本用法

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

1.7.0 (const: 1.52.0) · source

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

self 除以 rhs 时计算余数。

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

Panics

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

Examples

基本用法

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

1.38.0 (const: 1.52.0) · source

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

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

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

Panics

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

Examples

基本用法

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

1.7.0 (const: 1.32.0) · source

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

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

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

Examples

基本用法

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

1.7.0 (const: 1.32.0) · source

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

将 self 左移 rhs 位。

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

Examples

基本用法

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

1.7.0 (const: 1.32.0) · source

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

将 self 右移 rhs 位。

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

Examples

基本用法

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

1.34.0 (const: 1.50.0) · source

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

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

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

Examples

基本用法：

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

const: 1.50.0 · source

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

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

Examples

基本用法：

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

1.38.0 (const: 1.52.0) · source

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

执行欧几里得除法。

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

Panics

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

Examples

基本用法：

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

1.38.0 (const: 1.52.0) · source

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

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

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

Panics

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

Examples

基本用法：

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

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

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

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

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

Panics

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

Examples

基本用法：

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

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

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

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

Panics

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

溢出行为

溢出时，如果启用溢出检查 (默认在调试模式下)，此函数将 panic，如果禁用溢出检查 (默认在，生产模式，下)，则返回。

Examples

基本用法：

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

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

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

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

Panics

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

溢出行为

溢出时，如果启用溢出检查 (默认在调试模式下)，此函数将 panic，如果禁用溢出检查 (默认在，生产模式，下)，则返回。

Examples

基本用法：

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

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

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

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

Examples

基本用法：

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

const: 1.32.0 · source

pub const fn is_power_of_two(self) -> bool

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

Examples

基本用法：

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

const: 1.50.0 · source

pub const fn next_power_of_two(self) -> Self

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

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

Examples

基本用法：

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

const: 1.50.0 · source

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

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

Examples

基本用法：

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

const: unstable · source

pub fn wrapping_next_power_of_two(self) -> Self

🔬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!(2u8.wrapping_next_power_of_two(), 2);
assert_eq!(3u8.wrapping_next_power_of_two(), 4);
assert_eq!(u8::MAX.wrapping_next_power_of_two(), 0);

1.32.0 (const: 1.44.0) · source

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

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

Examples

let bytes = 0x12u8.to_be_bytes();
assert_eq!(bytes, [0x12]);

1.32.0 (const: 1.44.0) · source

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

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

Examples

let bytes = 0x12u8.to_le_bytes();
assert_eq!(bytes, [0x12]);

1.32.0 (const: 1.44.0) · source

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

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

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

Examples

let bytes = 0x12u8.to_ne_bytes();
assert_eq!(
    bytes,
    if cfg!(target_endian = "big") {
        [0x12]
    } else {
        [0x12]
    }
);

1.32.0 (const: 1.44.0) · source

pub const fn from_be_bytes(bytes: [u8; 1]) -> Self

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

Examples

let value = u8::from_be_bytes([0x12]);
assert_eq!(value, 0x12);

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

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

1.32.0 (const: 1.44.0) · source

pub const fn from_le_bytes(bytes: [u8; 1]) -> Self

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

Examples

let value = u8::from_le_bytes([0x12]);
assert_eq!(value, 0x12);

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

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

1.32.0 (const: 1.44.0) · source

pub const fn from_ne_bytes(bytes: [u8; 1]) -> Self

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

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

Examples

let value = u8::from_ne_bytes(if cfg!(target_endian = "big") {
    [0x12]
} else {
    [0x12]
});
assert_eq!(value, 0x12);

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

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

const: 1.32.0 · source

pub const fn min_value() -> Self

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

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

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

const: 1.32.0 · source

pub const fn max_value() -> Self

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

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

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

const: unstable · source

pub fn widening_mul(self, rhs: Self) -> (Self, Self)

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

计算完整的产品 self * rhs，没有溢出的可能性。

这将返回结果的低位 (wrapping) 位和高位 (overflow) 位作为两个单独的值，按该顺序。

如果您还需要在宽结果中添加进位，那么您需要 Self::carrying_mul。

Examples

基本用法：

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

#![feature(bigint_helper_methods)]
assert_eq!(5u32.widening_mul(2), (10, 0));
assert_eq!(1_000_000_000u32.widening_mul(10), (1410065408, 2));

const: unstable · source

pub fn carrying_mul(self, rhs: Self, carry: Self) -> (Self, Self)

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

计算 “full multiplication” self * rhs + carry 而不可能溢出。

这将返回结果的低位 (wrapping) 位和高位 (overflow) 位作为两个单独的值，按该顺序。

执行 “long multiplication”，它需要添加额外的量，并且可能返回额外的溢出量。这允许将多个乘法链接在一起以创建代表更大值的 “大整数”。

如果您不需要 carry，那么您可以使用 Self::widening_mul。

Examples

基本用法：

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

#![feature(bigint_helper_methods)]
assert_eq!(5u32.carrying_mul(2, 0), (10, 0));
assert_eq!(5u32.carrying_mul(2, 10), (20, 0));
assert_eq!(1_000_000_000u32.carrying_mul(10, 0), (1410065408, 2));
assert_eq!(1_000_000_000u32.carrying_mul(10, 10), (1410065418, 2));


assert_eq!(u8::MAX.carrying_mul(u8::MAX, u8::MAX), (0, u8::MAX));

This is the core operation needed for scalar multiplication when implementing it for wider-than-native types.


#![feature(bigint_helper_methods)]
fn scalar_mul_eq(little_endian_digits: &mut Vec<u16>, multiplicand: u16) {
    let mut carry = 0;
    对于 little_endian_digits.iter_mut() { (*d, carry) = d.carrying_mul(multiplicand, carry); } 中的 d 如果进位 != 0 {

        little_endian_digits.push(carry);
    }
}

let mut v = vec![10, 20];
scalar_mul_eq(&mut v, 3);
assert_eq!(v, [30, 60]);

assert_eq!(0x87654321_u64 * 0xFEED, 0x86D3D159E38D);
let mut v = vec![0x4321, 0x8765];
scalar_mul_eq(&mut v, 0xFEED);
assert_eq!(v, [0xE38D, 0xD159, 0x86D3]);

If carry is zero, this is similar to overflowing_mul, except that it gives the value of the overflow instead of just whether one happened:

#![feature(bigint_helper_methods)]
let r = u8::carrying_mul(7, 13, 0);
assert_eq!((r.0, r.1 != 0), u8::overflowing_mul(7, 13));
let r = u8::carrying_mul(13, 42, 0);
assert_eq!((r.0, r.1 != 0), u8::overflowing_mul(13, 42));

The value of the first field in the returned tuple matches what you’d get by combining the wrapping_mul and wrapping_add methods:

#![feature(bigint_helper_methods)]
assert_eq!(
    789_u16.carrying_mul(456, 123).0, 789_u16.wrapping_mul(456).wrapping_add(123), );

const: unstable · source

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

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

1.23.0 (const: 1.43.0) · source

pub const fn is_ascii(&self) -> bool

检查该值是否在 ASCII 范围内。

Examples

let ascii = 97u8;
let non_ascii = 150u8;

assert!(ascii.is_ascii());
assert!(!non_ascii.is_ascii());

这等效于 to_ascii_lowercase(a) == to_ascii_lowercase(b)。

Examples

let lowercase_a = 97u8;
let uppercase_a = 65u8;

assert!(lowercase_a.eq_ignore_ascii_case(&uppercase_a));

1.23.0 · source

pub fn make_ascii_uppercase(&mut self)

将此值就地转换为其 ASCII 大写等效项。

ASCII 字母 ‘a’ 到 ‘z’ 映射到 ‘A’ 到 ‘Z’，但是非 ASCII 字母不变。

要返回新的大写值而不修改现有值，请使用 to_ascii_uppercase。

Examples

let mut byte = b'a';

byte.make_ascii_uppercase();

assert_eq!(b'A', byte);

1.23.0 · source

pub fn make_ascii_lowercase(&mut self)

将此值就地转换为其 ASCII 小写等效项。

ASCII 字母 ‘A’ 到 ‘Z’ 映射到 ‘a’ 到 ‘z’，但是非 ASCII 字母不变。

要返回新的小写值而不修改现有值，请使用 to_ascii_lowercase。

Examples

let mut byte = b'A';

byte.make_ascii_lowercase();

assert_eq!(b'a', byte);

1.24.0 (const: 1.47.0) · source

pub const fn is_ascii_alphabetic(&self) -> bool

检查值是否为 ASCII 字母字符：

U+0041 ‘A’ ..= U+005A ‘Z’, or
U+0061 ‘a’ ..= U+007A ‘z’.

Examples

let uppercase_a = b'A';
let uppercase_g = b'G';
let a = b'a';
let g = b'g';
let zero = b'0';
let percent = b'%';
let space = b' ';
let lf = b'\n';
let esc = b'\x1b';

assert!(uppercase_a.is_ascii_alphabetic());
assert!(uppercase_g.is_ascii_alphabetic());
assert!(a.is_ascii_alphabetic());
assert!(g.is_ascii_alphabetic());
assert!(!zero.is_ascii_alphabetic());
assert!(!percent.is_ascii_alphabetic());
assert!(!space.is_ascii_alphabetic());
assert!(!lf.is_ascii_alphabetic());
assert!(!esc.is_ascii_alphabetic());

1.24.0 (const: 1.47.0) · source

pub const fn is_ascii_uppercase(&self) -> bool

检查值是否为 ASCII 大写字符： U+0041 ‘A’ ..= U+005A ‘Z’.

Examples

let uppercase_a = b'A';
let uppercase_g = b'G';
let a = b'a';
let g = b'g';
let zero = b'0';
let percent = b'%';
let space = b' ';
let lf = b'\n';
let esc = b'\x1b';

assert!(uppercase_a.is_ascii_uppercase());
assert!(uppercase_g.is_ascii_uppercase());
assert!(!a.is_ascii_uppercase());
assert!(!g.is_ascii_uppercase());
assert!(!zero.is_ascii_uppercase());
assert!(!percent.is_ascii_uppercase());
assert!(!space.is_ascii_uppercase());
assert!(!lf.is_ascii_uppercase());
assert!(!esc.is_ascii_uppercase());

1.24.0 (const: 1.47.0) · source

pub const fn is_ascii_lowercase(&self) -> bool

检查值是否为 ASCII 小写字符： U+0061 ‘a’ ..= U+007A ‘z’.

Examples

let uppercase_a = b'A';
let uppercase_g = b'G';
let a = b'a';
let g = b'g';
let zero = b'0';
let percent = b'%';
let space = b' ';
let lf = b'\n';
let esc = b'\x1b';

assert!(!uppercase_a.is_ascii_lowercase());
assert!(!uppercase_g.is_ascii_lowercase());
assert!(a.is_ascii_lowercase());
assert!(g.is_ascii_lowercase());
assert!(!zero.is_ascii_lowercase());
assert!(!percent.is_ascii_lowercase());
assert!(!space.is_ascii_lowercase());
assert!(!lf.is_ascii_lowercase());
assert!(!esc.is_ascii_lowercase());

1.24.0 (const: 1.47.0) · source

pub const fn is_ascii_alphanumeric(&self) -> bool

检查值是否为 ASCII 字母数字字符：

U+0041 ‘A’ ..= U+005A ‘Z’, or
U+0061 ‘a’ ..= U+007A ‘z’, or
U+0030 ‘0’ ..= U+0039 ‘9’.

Examples

let uppercase_a = b'A';
let uppercase_g = b'G';
let a = b'a';
let g = b'g';
let zero = b'0';
let percent = b'%';
let space = b' ';
let lf = b'\n';
let esc = b'\x1b';

assert!(uppercase_a.is_ascii_alphanumeric());
assert!(uppercase_g.is_ascii_alphanumeric());
assert!(a.is_ascii_alphanumeric());
assert!(g.is_ascii_alphanumeric());
assert!(zero.is_ascii_alphanumeric());
assert!(!percent.is_ascii_alphanumeric());
assert!(!space.is_ascii_alphanumeric());
assert!(!lf.is_ascii_alphanumeric());
assert!(!esc.is_ascii_alphanumeric());

1.24.0 (const: 1.47.0) · source

pub const fn is_ascii_digit(&self) -> bool

检查值是否为 ASCII 十进制数字： U+0030 ‘0’ ..= U+0039 ‘9’.

Examples

let uppercase_a = b'A';
let uppercase_g = b'G';
let a = b'a';
let g = b'g';
let zero = b'0';
let percent = b'%';
let space = b' ';
let lf = b'\n';
let esc = b'\x1b';

assert!(!uppercase_a.is_ascii_digit());
assert!(!uppercase_g.is_ascii_digit());
assert!(!a.is_ascii_digit());
assert!(!g.is_ascii_digit());
assert!(zero.is_ascii_digit());
assert!(!percent.is_ascii_digit());
assert!(!space.is_ascii_digit());
assert!(!lf.is_ascii_digit());
assert!(!esc.is_ascii_digit());

const: unstable · source

pub fn is_ascii_octdigit(&self) -> bool

🔬This is a nightly-only experimental API. (is_ascii_octdigit #101288)

检查值是否为 ASCII 八进制数字: U+0030 ‘0’ ..= U+0037 ‘7’.

Examples

#![feature(is_ascii_octdigit)]

let uppercase_a = b'A';
let a = b'a';
let zero = b'0';
let seven = b'7';
let nine = b'9';
let percent = b'%';
let lf = b'\n';

assert!(!uppercase_a.is_ascii_octdigit());
assert!(!a.is_ascii_octdigit());
assert!(zero.is_ascii_octdigit());
assert!(seven.is_ascii_octdigit());
assert!(!nine.is_ascii_octdigit());
assert!(!percent.is_ascii_octdigit());
assert!(!lf.is_ascii_octdigit());

1.24.0 (const: 1.47.0) · source

pub const fn is_ascii_hexdigit(&self) -> bool

检查值是否为 ASCII 十六进制数字：

U+0030 ‘0’ ..= U+0039 ‘9’, or
U+0041 ‘A’ ..= U+0046 ‘F’, or
U+0061 ‘a’ ..= U+0066 ‘f’.

Examples

let uppercase_a = b'A';
let uppercase_g = b'G';
let a = b'a';
let g = b'g';
let zero = b'0';
let percent = b'%';
let space = b' ';
let lf = b'\n';
let esc = b'\x1b';

assert!(uppercase_a.is_ascii_hexdigit());
assert!(!uppercase_g.is_ascii_hexdigit());
assert!(a.is_ascii_hexdigit());
assert!(!g.is_ascii_hexdigit());
assert!(zero.is_ascii_hexdigit());
assert!(!percent.is_ascii_hexdigit());
assert!(!space.is_ascii_hexdigit());
assert!(!lf.is_ascii_hexdigit());
assert!(!esc.is_ascii_hexdigit());

1.24.0 (const: 1.47.0) · source

pub const fn is_ascii_punctuation(&self) -> bool

检查值是否为 ASCII 标点符号：

U+0021 ..= U+002F ! " # $ % & ' ( ) * + , - . /, or
U+003A ..= U+0040 : ; < = > ? @, or
U+005B ..= U+0060 [ \ ] ^ _ `，或
U+007B ..= U+007E { | } ~

Examples

let uppercase_a = b'A';
let uppercase_g = b'G';
let a = b'a';
let g = b'g';
let zero = b'0';
let percent = b'%';
let space = b' ';
let lf = b'\n';
let esc = b'\x1b';

assert!(!uppercase_a.is_ascii_punctuation());
assert!(!uppercase_g.is_ascii_punctuation());
assert!(!a.is_ascii_punctuation());
assert!(!g.is_ascii_punctuation());
assert!(!zero.is_ascii_punctuation());
assert!(percent.is_ascii_punctuation());
assert!(!space.is_ascii_punctuation());
assert!(!lf.is_ascii_punctuation());
assert!(!esc.is_ascii_punctuation());

1.24.0 (const: 1.47.0) · source

pub const fn is_ascii_graphic(&self) -> bool

检查值是否为 ASCII 图形字符： U+0021 ‘!’ ..= U+007E ‘~’.

Examples

let uppercase_a = b'A';
let uppercase_g = b'G';
let a = b'a';
let g = b'g';
let zero = b'0';
let percent = b'%';
let space = b' ';
let lf = b'\n';
let esc = b'\x1b';

assert!(uppercase_a.is_ascii_graphic());
assert!(uppercase_g.is_ascii_graphic());
assert!(a.is_ascii_graphic());
assert!(g.is_ascii_graphic());
assert!(zero.is_ascii_graphic());
assert!(percent.is_ascii_graphic());
assert!(!space.is_ascii_graphic());
assert!(!lf.is_ascii_graphic());
assert!(!esc.is_ascii_graphic());

1.24.0 (const: 1.47.0) · source

pub const fn is_ascii_whitespace(&self) -> bool

检查值是否为 ASCII 空格字符： U+0020 空格、U+0009 水平制表符、U+000A 换行、U+000C 换页或 U+000D 回车。

Rust 使用 WhatWG 基础标准的 ASCII 空格的定义。还有其他几种广泛使用的定义。例如，POSIX 语言环境包括 U+000B 垂直标签以及所有上述字符，但是 - 从相同的规格来看 -Bourne shell 中 “field splitting” 的默认规则仅考虑空格，水平标签和 LINE FEED 作为空白。

如果要编写将处理现有文件格式的程序，请在使用此函数之前检查该格式的空格定义。

Examples

let uppercase_a = b'A';
let uppercase_g = b'G';
let a = b'a';
let g = b'g';
let zero = b'0';
let percent = b'%';
let space = b' ';
let lf = b'\n';
let esc = b'\x1b';

assert!(!uppercase_a.is_ascii_whitespace());
assert!(!uppercase_g.is_ascii_whitespace());
assert!(!a.is_ascii_whitespace());
assert!(!g.is_ascii_whitespace());
assert!(!zero.is_ascii_whitespace());
assert!(!percent.is_ascii_whitespace());
assert!(space.is_ascii_whitespace());
assert!(lf.is_ascii_whitespace());
assert!(!esc.is_ascii_whitespace());

1.24.0 (const: 1.47.0) · source

pub const fn is_ascii_control(&self) -> bool

检查值是否为 ASCII 控制字符： U+0000 NUL ..= U+001F 单元分隔符，或 U+007F 删除。请注意，大多数 ASCII 空格字符是控制字符，而 SPACE 不是。

Examples

let uppercase_a = b'A';
let uppercase_g = b'G';
let a = b'a';
let g = b'g';
let zero = b'0';
let percent = b'%';
let space = b' ';
let lf = b'\n';
let esc = b'\x1b';

assert!(!uppercase_a.is_ascii_control());
assert!(!uppercase_g.is_ascii_control());
assert!(!a.is_ascii_control());
assert!(!g.is_ascii_control());
assert!(!zero.is_ascii_control());
assert!(!percent.is_ascii_control());
assert!(!space.is_ascii_control());
assert!(lf.is_ascii_control());
assert!(esc.is_ascii_control());

1.60.0 · source

pub fn escape_ascii(self) -> EscapeDefault ⓘ

返回生成 u8 的转义版本的迭代器，将其视为 ASCII 字符。

行为与 ascii::escape_default 相同。

Examples


assert_eq!("0", b'0'.escape_ascii().to_string());
assert_eq!("\\t", b'\t'.escape_ascii().to_string());
assert_eq!("\\r", b'\r'.escape_ascii().to_string());
assert_eq!("\\n", b'\n'.escape_ascii().to_string());
assert_eq!("\\'", b'\''.escape_ascii().to_string());
assert_eq!("\\\"", b'"'.escape_ascii().to_string());
assert_eq!("\\\\", b'\\'.escape_ascii().to_string());
assert_eq!("\\x9d", b'\x9d'.escape_ascii().to_string());

impl Debug for u8

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

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

impl Default for u8

fn default() -> u8

Returns the default value of 0

This operation will panic if other == 0.

type Output = u8

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

fn from(small: bool) -> Self

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

Examples

assert_eq!(u8::from(true), 1);
assert_eq!(u8::from(false), 0);

1.34.0 · source§

impl From<u8> for AtomicU8

fn from(v: u8) -> Self

Converts an u8 into an AtomicU8.

1.13.0 · source§

impl From<u8> for char

将 0x00..=0xFF 中的字节映射到 char，该 char 的代码点具有相同的值，即 U+0000..=U+00FF。

Unicode 的设计使其可以使用 IANA 称为 ISO-8859-1 的字符编码有效地解码字节。此编码与 ASCII 兼容。

请注意，这与 ISO/IEC 8859-1 又名不同 ISO 8859-1 (连字符少一个)，它留下了一些 “blanks” 字节值，这些值未分配给任何字符。 ISO-8859-1 (属于 IANA) 将它们分配给 C0 和 C1 控制代码。

请注意，这也与 Windows-1252 也不同代码页 1252，它是 ISO/IEC 8859-1 的超集，它为标点符号和各种拉丁字符分配了一些 (不是全部) 空格。

为了进一步混淆，在 Web 上 ascii，iso-8859-1 和 windows-1252 都是 Windows-1252 超集的别名，该超集用相应的 C0 和 C1 控制代码填充了其余的空白。

fn from(i: u8) -> Self

将 u8 转换为 char。

Examples

use std::mem;

let u = 32 as u8;
let c = char::from(u);
assert!(4 == mem::size_of_val(&c))

impl Hash for u8

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

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

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

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

1.42.0 · source§

impl LowerExp for u8

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

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

impl Not for u8

type Output = u8

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

比较并返回两个值中的最大值。 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,

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

impl PartialEq<u8> for u8

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

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

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

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

fn product<I: Iterator<Item = &'a Self>>(iter: I) -> Self

该方法采用迭代器并通过乘以项从元素生成 Self。

1.12.0 · source§

This operation will panic if other == 0.

type Output = u8

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

impl TryFrom<char> for u8

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

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

impl TrustedStep for u8

fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>

执行转换。

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

type Error = >::Error

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