Primitive Type unit

() 类型，也称为 “unit”。

() 类型只有一个值 ()，在没有其他有意义的值可以返回时使用。 () 最常见的是隐式的：没有 -> ... 的函数隐式具有返回类型 ()，也就是说，它们是等价的：

fn long() -> () {}

fn short() {}

分号 ; 可用于在块末尾丢弃表达式的结果，从而使表达式 (从而使该块) 的值为 ()。

例如，

fn returns_i64() -> i64 {
    1i64
}
fn returns_unit() {
    1i64;
}

let is_i64 = {
    returns_i64()
};
let is_unit = {
    returns_i64();
};

Trait Implementations

impl Clone for ()

fn clone(&self) -> Self

返回值的副本。

fn clone_from(&mut self, source: &Self)

从 source 执行复制分配。

impl Debug for ()

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

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

impl Default for ()

fn default()

Returns the default value of ()

impl Extend<()> for ()

fn extend<T>(&mut self, iter: T)where T: IntoIterator<Item = ()>,

使用迭代器的内容扩展集合。

fn extend_one(&mut self, _item: ())

🔬This is a nightly-only experimental API. (extend_one #72631)

用一个元素扩展一个集合。

fn extend_reserve(&mut self, additional: usize)

🔬This is a nightly-only experimental API. (extend_one #72631)

在集合中为给定数量的附加元素保留容量。

impl FromIterator<()> for ()

将一个迭代器中的所有 unit 项折叠为一个。

与更高级别的抽象结合使用时，此功能尤其有用，例如收集到仅关心错误的 Result<(), E> 上：

use std::io::*;
let data = vec![1, 2, 3, 4, 5];
let res: Result<()> = data.iter()
    .map(|x| writeln!(stdout(), "{x}"))
    .collect();
assert!(res.is_ok());

fn from_iter<I>(iter: I)where I: IntoIterator<Item = ()>,

从迭代器创建一个值。

impl Hash for ()

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

将该值输入给定的 Hasher。

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

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

impl Ord for ()

fn cmp(&self, _other: &()) -> Ordering

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

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

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

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

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

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

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

impl PartialEq<()> for ()

fn eq(&self, _other: &()) -> bool

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

fn ne(&self, _other: &()) -> bool

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

impl PartialOrd<()> for ()

fn partial_cmp(&self, _: &()) -> Option<Ordering>

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

fn lt(&self, other: &Rhs) -> bool

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

fn le(&self, other: &Rhs) -> bool

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

fn gt(&self, other: &Rhs) -> bool

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

fn ge(&self, other: &Rhs) -> bool

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

impl Termination for ()

fn report(self) -> ExitCode

被调用以获取值的表示形式作为状态码。 此状态代码返回到操作系统。

impl Copy for ()

impl Eq for ()