Function core::mem::needs_drop
1.21.0 (const: 1.36.0) · source · pub const fn needs_drop<T: ?Sized>() -> bool
Expand description
如果丢弃类型为 T
的值很重要,则返回 true
。
这纯粹是一个优化提示,可以保守地实现:
对于实际上不需要丢弃的类型,它可能返回 true
。
因此,始终返回 true
将是此函数的有效实现。但是,如果此函数实际返回 false
,则可以确定丢弃 T
没有副作用。
需要手动丢弃其数据的诸如集合之类的底层实现,应使用此函数来避免在销毁它们时不必要地丢弃其所有内容。
这可能不会对发行版本产生影响 (可以轻松检测并消除没有副作用的循环),但是对于调试版本而言,这通常是一个大胜利。
请注意,drop_in_place
已经执行了此检查,因此,如果您的工作量可以减少到少量的 drop_in_place
调用,则无需使用此功能。
特别要注意的是,您可以 drop_in_place
一个切片,这将对所有值进行一次 needs_drop 检查。
因此,像 Vec 这样的类型只是 drop_in_place(&mut self[..])
,而没有显式使用 needs_drop
。
另一方面,像 HashMap
这样的类型必须一次丢弃一个值,并且应使用此 API。
Examples
这是一个集合如何利用 needs_drop
的示例:
use std::{mem, ptr};
pub struct MyCollection<T> {
/* ... */
}
impl<T> Drop for MyCollection<T> {
fn drop(&mut self) {
unsafe {
// 丢弃数据
if mem::needs_drop::<T>() {
for x in self.iter_mut() {
ptr::drop_in_place(x);
}
}
self.free_buffer();
}
}
}
Run