Trait std::default::Default1.0.0[−][src]

pub trait Default {
    fn default() -> Self;
}
Expand description

trait，用于为类型提供有用的默认值。

有时，您希望回退到某种默认值，而不必特别关心它的含义。 这经常出现在定义一组选项的 struct 中:

struct SomeOptions {
    foo: i32,
    bar: f32,
}
Run

我们如何定义一些默认值? 您可以使用 Default:

#[derive(Default)]
struct SomeOptions {
    foo: i32,
    bar: f32,
}

fn main() {
    let options: SomeOptions = Default::default();
}
Run

现在，您将获得所有默认值。Rust 为各种基本类型实现 Default。

如果要覆盖特定选项，但仍保留其他默认值:

fn main() {
    let options = SomeOptions { foo: 42, ..Default::default() };
}
Run

Derivable

如果类型的所有字段都实现 Default，则此 trait 可以与 #[derive] 一起使用。 当 derived 时，它将为每个字段的类型使用默认值。

如何实现 Default?

提供 default() 方法的实现，该实现返回您类型的值，该值应为默认值:

enum Kind {
    A,
    B,
    C,
}

impl Default for Kind {
    fn default() -> Self { Kind::A }
}
Run

Examples

#[derive(Default)]
struct SomeOptions {
    foo: i32,
    bar: f32,
}
Run

Required methods

返回类型的 “default value”。

默认值通常是某种初始值，标识值或其他可能有意义的默认值。

Examples

使用内置的默认值:

let i: i8 = Default::default();
let (x, y): (Option<String>, f64) = Default::default();
let (a, b, (c, d)): (i32, u32, (bool, bool)) = Default::default();
Run

自己制作:

enum Kind {
    A,
    B,
    C,
}

impl Default for Kind {
    fn default() -> Self { Kind::A }
}
Run

Implementors

创建一个空的 OsStr。

Returns the default value of false

Returns the default value of \x00

Returns the default value of 0.0

Returns the default value of 0.0

Returns the default value of 0

Returns the default value of 0

Returns the default value of 0

Returns the default value of 0

Returns the default value of 0

Returns the default value of 0

Returns the default value of 0

Returns the default value of 0

Returns the default value of 0

Returns the default value of 0

Returns the default value of 0

Returns the default value of ()

Returns the default value of 0

使用 new 创建一个新的 DefaultHasher。 有关更多信息，请参见其文档。

创建一个新的 RandomState。

创建一个空的 CString。

创建一个空的 OsString。

创建一个空的 String。

创建一个初始化为 false 的 AtomicBool。

创建一个 Condvar，可以等待它并通知它。

创建一个空的 str

创建一个空的可变 str

创建一个拥有的 Cow<’a, B>，其默认值为包含的拥有值。

创建一个空的切片。

创建一个可变的空切片。

创建一个空的 BTreeMap。

创建一个空的 HashMap<K, V, S>，其哈希值为 Default。

返回 None。

Examples

let opt: Option<u32> = Option::default();
assert!(opt.is_none());
Run

创建一个 Box<T>，其 T 值为 Default。

创建一个 Cell<T>，其 T 值为 Default。

创建一个 RefCell<T>，其 T 值为 Default。

创建一个 UnsafeCell，其 T 值为 Default。

创建一个空的 BTreeSet。

创建一个空的 BinaryHeap<T>。

创建一个空的 LinkedList<T>。

创建一个空的 VecDeque<T>。

使用 Default 作为初始化函数创建一个新的惰性值。

用 T 的 Default 值创建一个新的 Rc<T>。

Examples

use std::rc::Rc;

let x: Rc<i32> = Default::default();
assert_eq!(*x, 0);
Run

创建一个新的 Weak<T>，而不分配任何内存。 在返回值上调用 upgrade 总是得到 None。

Examples

use std::rc::Weak;

let empty: Weak<i64> = Default::default();
assert!(empty.upgrade().is_none());
Run

创建一个空 AtomicPtr<T>。

用 T 的 Default 值创建一个新的 Arc<T>。

Examples

use std::sync::Arc;

let x: Arc<i32> = Default::default();
assert_eq!(*x, 0);
Run

创建一个新的 Weak<T>，而不分配内存。 在返回值上调用 upgrade 总是得到 None。

Examples

use std::sync::Weak;

let empty: Weak<i64> = Default::default();
assert!(empty.upgrade().is_none());
Run

创建一个空的 Vec<T>。

用哈希器的 Default 值创建一个空的 HashSet<T, S>。

使用 Default 作为初始化函数创建一个新的惰性值。

用 T 的 Default 值创建一个新的 RwLock<T>。

创建一个 Mutex<T>，其 T 值为 Default。