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 Debug for ()

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

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

impl Default for ()

pub fn default()

Returns the default value of ()

impl Extend<()> for ()

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

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

pub 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());

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

从迭代器创建一个值。

impl Hash for ()

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

将该值输入给定的 Hasher。

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

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

impl Ord for ()

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

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

#[must_use]

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

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

#[must_use]

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

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

#[must_use]

fn clamp(self, min: Self, max: Self) -> Self

将值限制为一定的时间间隔。

impl PartialEq<()> for ()

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

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

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

此方法测试 !=。

impl PartialOrd<()> for ()

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

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

#[must_use]

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

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

#[must_use]

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

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

#[must_use]

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

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

#[must_use]

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

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

impl Termination for ()

fn report(self) -> i32

🔬 This is a nightly-only experimental API. (termination_trait_lib #43301)

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

impl Eq for ()