Struct alloc::boxed::Box

pub struct Box<T: ?Sized, A: Allocator = Global>(_, _);

堆分配的指针类型。

有关更多信息，请参见 模块级文档。

Implementations

impl<T> Box<T>

pub fn new(x: T) -> Self

在堆上分配内存，然后将 x 放入其中。

如果 T 的大小为零，则实际上不会分配。

Examples

let five = Box::new(5);

pub fn new_uninit() -> Box<MaybeUninit<T>>

🔬 This is a nightly-only experimental API. (new_uninit #63291)

创建一个具有未初始化内容的新 box。

Examples

#![feature(new_uninit)]

let mut five = Box::<u32>::new_uninit();

let five = unsafe {
    // 延迟初始化:
    five.as_mut_ptr().write(5);

    five.assume_init()
};

assert_eq!(*five, 5)

pub fn new_zeroed() -> Box<MaybeUninit<T>>

🔬 This is a nightly-only experimental API. (new_uninit #63291)

创建一个具有未初始化内容的新 Box，并用 0 字节填充内存。

有关正确和不正确使用此方法的示例，请参见 MaybeUninit::zeroed。

Examples

#![feature(new_uninit)]

let zero = Box::<u32>::new_zeroed();
let zero = unsafe { zero.assume_init() };

assert_eq!(*zero, 0)

pub fn pin(x: T) -> Pin<Box<T>>

创建一个新的 Pin<Box<T>>。 如果 T 未实现 Unpin，则 x 将被固定在内存中并且无法移动。

pub fn try_new(x: T) -> Result<Self, AllocError>

🔬 This is a nightly-only experimental API. (allocator_api #32838)

在堆上分配内存，然后将 x 放入其中，如果分配失败，则返回错误

如果 T 的大小为零，则实际上不会分配。

Examples

#![feature(allocator_api)]

let five = Box::try_new(5)?;

pub fn try_new_uninit() -> Result<Box<MaybeUninit<T>>, AllocError>

🔬 This is a nightly-only experimental API. (allocator_api #32838)

在堆上创建一个具有未初始化内容的新 box，如果分配失败，则返回错误

Examples

#![feature(allocator_api, new_uninit)]

let mut five = Box::<u32>::try_new_uninit()?;

let five = unsafe {
    // 延迟初始化:
    five.as_mut_ptr().write(5);

    five.assume_init()
};

assert_eq!(*five, 5);

pub fn try_new_zeroed() -> Result<Box<MaybeUninit<T>>, AllocError>

🔬 This is a nightly-only experimental API. (allocator_api #32838)

创建一个具有未初始化内容的新 Box，堆中的内存由 0 字节填充

有关正确和不正确使用此方法的示例，请参见 MaybeUninit::zeroed。

Examples

#![feature(allocator_api, new_uninit)]

let zero = Box::<u32>::try_new_zeroed()?;
let zero = unsafe { zero.assume_init() };

assert_eq!(*zero, 0);

impl<T, A: Allocator> Box<T, A>

pub fn new_in(x: T, alloc: A) -> Self

🔬 This is a nightly-only experimental API. (allocator_api #32838)

在给定的分配器中分配内存，然后将 x 放入其中。

如果 T 的大小为零，则实际上不会分配。

Examples

#![feature(allocator_api)]

use std::alloc::System;

let five = Box::new_in(5, System);

pub fn try_new_in(x: T, alloc: A) -> Result<Self, AllocError>

🔬 This is a nightly-only experimental API. (allocator_api #32838)

在给定的分配器中分配内存，然后将 x 放入其中，如果分配失败，则返回错误

如果 T 的大小为零，则实际上不会分配。

Examples

#![feature(allocator_api)]

use std::alloc::System;

let five = Box::try_new_in(5, System)?;

pub fn new_uninit_in(alloc: A) -> Box<MaybeUninit<T>, A>

🔬 This is a nightly-only experimental API. (allocator_api #32838)

在提供的分配器中创建一个具有未初始化内容的新 box。

Examples

#![feature(allocator_api, new_uninit)]

use std::alloc::System;

let mut five = Box::<u32, _>::new_uninit_in(System);

let five = unsafe {
    // 延迟初始化:
    five.as_mut_ptr().write(5);

    five.assume_init()
};

assert_eq!(*five, 5)

pub fn try_new_uninit_in(alloc: A) -> Result<Box<MaybeUninit<T>, A>, AllocError>

🔬 This is a nightly-only experimental API. (allocator_api #32838)

在提供的分配器中创建一个具有未初始化内容的新 box，如果分配失败，则返回错误

Examples

#![feature(allocator_api, new_uninit)]

use std::alloc::System;

let mut five = Box::<u32, _>::try_new_uninit_in(System)?;

let five = unsafe {
    // 延迟初始化:
    five.as_mut_ptr().write(5);

    five.assume_init()
};

assert_eq!(*five, 5);

pub fn new_zeroed_in(alloc: A) -> Box<MaybeUninit<T>, A>

🔬 This is a nightly-only experimental API. (allocator_api #32838)

创建一个具有未初始化内容的新 Box，使用提供的分配器中的 0 字节填充内存。

有关正确和不正确使用此方法的示例，请参见 MaybeUninit::zeroed。

Examples

#![feature(allocator_api, new_uninit)]

use std::alloc::System;

let zero = Box::<u32, _>::new_zeroed_in(System);
let zero = unsafe { zero.assume_init() };

assert_eq!(*zero, 0)

pub fn try_new_zeroed_in(alloc: A) -> Result<Box<MaybeUninit<T>, A>, AllocError>

🔬 This is a nightly-only experimental API. (allocator_api #32838)

创建一个具有未初始化内容的新 Box，使用提供的分配器中的 0 字节填充内存，如果分配失败，则返回错误，

有关正确和不正确使用此方法的示例，请参见 MaybeUninit::zeroed。

Examples

#![feature(allocator_api, new_uninit)]

use std::alloc::System;

let zero = Box::<u32, _>::try_new_zeroed_in(System)?;
let zero = unsafe { zero.assume_init() };

assert_eq!(*zero, 0);

pub fn pin_in(x: T, alloc: A) -> Pin<Self> where
    A: 'static, 

🔬 This is a nightly-only experimental API. (allocator_api #32838)

创建一个新的 Pin<Box<T, A>>。 如果 T 未实现 Unpin，则 x 将被固定在内存中并且无法移动。

pub fn into_boxed_slice(boxed: Self) -> Box<[T], A>

🔬 This is a nightly-only experimental API. (box_into_boxed_slice #71582)

将 Box<T> 转换为 Box<[T]>

这种转换不会在堆上分配，而是就地进行。

pub fn into_inner(boxed: Self) -> T

🔬 This is a nightly-only experimental API. (box_into_inner #80437)

消耗 Box，返回包装的值。

Examples

#![feature(box_into_inner)]

let c = Box::new(5);

assert_eq!(Box::into_inner(c), 5);

impl<T> Box<[T]>

pub fn new_uninit_slice(len: usize) -> Box<[MaybeUninit<T>]>

🔬 This is a nightly-only experimental API. (new_uninit #63291)

创建一个具有未初始化内容的新 boxed 切片。

Examples

#![feature(new_uninit)]

let mut values = Box::<[u32]>::new_uninit_slice(3);

let values = unsafe {
    // 延迟初始化:
    values[0].as_mut_ptr().write(1);
    values[1].as_mut_ptr().write(2);
    values[2].as_mut_ptr().write(3);

    values.assume_init()
};

assert_eq!(*values, [1, 2, 3])

pub fn new_zeroed_slice(len: usize) -> Box<[MaybeUninit<T>]>

🔬 This is a nightly-only experimental API. (new_uninit #63291)

创建一个具有未初始化内容的新 boxed 切片，并用 0 字节填充内存。

有关正确和不正确使用此方法的示例，请参见 MaybeUninit::zeroed。

Examples

#![feature(new_uninit)]

let values = Box::<[u32]>::new_zeroed_slice(3);
let values = unsafe { values.assume_init() };

assert_eq!(*values, [0, 0, 0])

impl<T, A: Allocator> Box<[T], A>

pub fn new_uninit_slice_in(len: usize, alloc: A) -> Box<[MaybeUninit<T>], A>

🔬 This is a nightly-only experimental API. (allocator_api #32838)

使用提供的分配器中未初始化的内容创建一个新的 boxed 切片。

Examples

#![feature(allocator_api, new_uninit)]

use std::alloc::System;

let mut values = Box::<[u32], _>::new_uninit_slice_in(3, System);

let values = unsafe {
    // 延迟初始化:
    values[0].as_mut_ptr().write(1);
    values[1].as_mut_ptr().write(2);
    values[2].as_mut_ptr().write(3);

    values.assume_init()
};

assert_eq!(*values, [1, 2, 3])

pub fn new_zeroed_slice_in(len: usize, alloc: A) -> Box<[MaybeUninit<T>], A>

🔬 This is a nightly-only experimental API. (allocator_api #32838)

使用提供的分配器中未初始化的内容创建一个新的 boxed 切片，并用 0 字节填充内存。

有关正确和不正确使用此方法的示例，请参见 MaybeUninit::zeroed。

Examples

#![feature(allocator_api, new_uninit)]

use std::alloc::System;

let values = Box::<[u32], _>::new_zeroed_slice_in(3, System);
let values = unsafe { values.assume_init() };

assert_eq!(*values, [0, 0, 0])

impl<T, A: Allocator> Box<MaybeUninit<T>, A>

pub unsafe fn assume_init(self) -> Box<T, A>

🔬 This is a nightly-only experimental API. (new_uninit #63291)

转换为 Box<T, A>。

Safety

与 MaybeUninit::assume_init 一样，由调用方负责确保该值确实处于初始化状态。

在内容尚未完全初始化时调用此方法会立即导致未定义的行为。

Examples

#![feature(new_uninit)]

let mut five = Box::<u32>::new_uninit();

let five: Box<u32> = unsafe {
    // 延迟初始化:
    five.as_mut_ptr().write(5);

    five.assume_init()
};

assert_eq!(*five, 5)

impl<T, A: Allocator> Box<[MaybeUninit<T>], A>

pub unsafe fn assume_init(self) -> Box<[T], A>

🔬 This is a nightly-only experimental API. (new_uninit #63291)

转换为 Box<[T], A>。

Safety

与 MaybeUninit::assume_init 一样，由调用方负责确保值确实处于初始化状态。

在内容尚未完全初始化时调用此方法会立即导致未定义的行为。

Examples

#![feature(new_uninit)]

let mut values = Box::<[u32]>::new_uninit_slice(3);

let values = unsafe {
    // 延迟初始化:
    values[0].as_mut_ptr().write(1);
    values[1].as_mut_ptr().write(2);
    values[2].as_mut_ptr().write(3);

    values.assume_init()
};

assert_eq!(*values, [1, 2, 3])

impl<T: ?Sized> Box<T>

pub unsafe fn from_raw(raw: *mut T) -> Self

从裸指针构造 box。

调用此函数后，结果 Box 拥有裸指针。 具体来说，Box 析构函数将调用 T 的析构函数并释放分配的内存。 为了安全起见，必须根据 Box 所使用的 memory layout 分配内存。

Safety

此函数不安全，因为使用不当可能会导致内存问题。 例如，如果在同一裸指针上两次调用该函数，则可能会出现 double-free。

安全条件在 memory layout 部分中进行了描述。

Examples

重新创建以前使用 Box::into_raw 转换为裸指针的 Box:

let x = Box::new(5);
let ptr = Box::into_raw(x);
let x = unsafe { Box::from_raw(ptr) };

使用二进制分配器从头开始手动创建 Box:

use std::alloc::{alloc, Layout};

unsafe {
    let ptr = alloc(Layout::new::<i32>()) as *mut i32;
    // 通常，需要 .write 以避免尝试销毁 `ptr` 以前的内容，尽管对于这个简单的示例 `*ptr = 5` 也可以工作。
    ptr.write(5);
    let x = Box::from_raw(ptr);
}

impl<T: ?Sized, A: Allocator> Box<T, A>

pub unsafe fn from_raw_in(raw: *mut T, alloc: A) -> Self

🔬 This is a nightly-only experimental API. (allocator_api #32838)

从给定分配器中的裸指针构造 box。

调用此函数后，结果 Box 拥有裸指针。 具体来说，Box 析构函数将调用 T 的析构函数并释放分配的内存。 为了安全起见，必须根据 Box 所使用的 memory layout 分配内存。

Safety

此函数不安全，因为使用不当可能会导致内存问题。 例如，如果在同一裸指针上两次调用该函数，则可能会出现 double-free。

Examples

重新创建以前使用 Box::into_raw_with_allocator 转换为裸指针的 Box:

#![feature(allocator_api)]

use std::alloc::System;

let x = Box::new_in(5, System);
let (ptr, alloc) = Box::into_raw_with_allocator(x);
let x = unsafe { Box::from_raw_in(ptr, alloc) };

使用系统分配器从头开始手动创建 Box:

#![feature(allocator_api, slice_ptr_get)]

use std::alloc::{Allocator, Layout, System};

unsafe {
    let ptr = System.allocate(Layout::new::<i32>())?.as_mut_ptr() as *mut i32;
    // 通常，需要 .write 以避免尝试销毁 `ptr` 以前的内容，尽管对于这个简单的示例 `*ptr = 5` 也可以工作。
    ptr.write(5);
    let x = Box::from_raw_in(ptr, System);
}

pub fn into_raw(b: Self) -> *mut T

消耗 Box，并返回一个包装的裸指针。

指针将正确对齐且不为空。

调用此函数后，调用者将负责先前由 Box 管理的内存。 特别地，考虑到 Box 使用的 memory layout，调用者应正确销毁 T 并释放内存。 最简单的方法是使用 Box::from_raw 函数将裸指针转换回 Box，从而允许 Box 析构函数执行清理。

Note: 这是一个关联函数，这意味着您必须将其称为 Box::into_raw(b) 而不是 b.into_raw()。 这样就不会与内部类型的方法发生冲突。

Examples

使用 Box::from_raw 将裸指针转换回 Box 以进行自动清理:

let x = Box::new(String::from("Hello"));
let ptr = Box::into_raw(x);
let x = unsafe { Box::from_raw(ptr) };

通过显式运行析构函数并释放内存来进行手动清理:

use std::alloc::{dealloc, Layout};
use std::ptr;

let x = Box::new(String::from("Hello"));
let p = Box::into_raw(x);
unsafe {
    ptr::drop_in_place(p);
    dealloc(p as *mut u8, Layout::new::<String>());
}

pub fn into_raw_with_allocator(b: Self) -> (*mut T, A)

🔬 This is a nightly-only experimental API. (allocator_api #32838)

消耗 Box，返回包装的裸指针和分配器。

指针将正确对齐且不为空。

调用此函数后，调用者将负责先前由 Box 管理的内存。 特别地，考虑到 Box 使用的 memory layout，调用者应正确销毁 T 并释放内存。 最简单的方法是使用 Box::from_raw_in 函数将裸指针转换回 Box，从而允许 Box 析构函数执行清理。

Note: 这是一个关联函数，这意味着您必须将其称为 Box::into_raw_with_allocator(b) 而不是 b.into_raw_with_allocator()。 这样就不会与内部类型的方法发生冲突。

Examples

使用 Box::from_raw_in 将裸指针转换回 Box 以进行自动清理:

#![feature(allocator_api)]

use std::alloc::System;

let x = Box::new_in(String::from("Hello"), System);
let (ptr, alloc) = Box::into_raw_with_allocator(x);
let x = unsafe { Box::from_raw_in(ptr, alloc) };

通过显式运行析构函数并释放内存来进行手动清理:

#![feature(allocator_api)]

use std::alloc::{Allocator, Layout, System};
use std::ptr::{self, NonNull};

let x = Box::new_in(String::from("Hello"), System);
let (ptr, alloc) = Box::into_raw_with_allocator(x);
unsafe {
    ptr::drop_in_place(ptr);
    let non_null = NonNull::new_unchecked(ptr);
    alloc.deallocate(non_null.cast(), Layout::new::<String>());
}

pub fn allocator(b: &Self) -> &A

🔬 This is a nightly-only experimental API. (allocator_api #32838)

返回基础分配器的引用。

Note: 这是一个关联函数，这意味着您必须将其称为 Box::allocator(&b) 而不是 b.allocator()。 这样就不会与内部类型的方法发生冲突。

pub fn leak<'a>(b: Self) -> &'a mut T where
    A: 'a, 

消耗并泄漏 Box，返回变量引用， &'a mut T. 请注意，类型 T 必须超过所选的生命周期 'a。 如果类型仅具有静态引用，或者根本没有静态引用，则可以将其选择为 'static。

该函数主要用于在程序的剩余生命期内保留的数据。 丢弃返回的引用将导致内存泄漏。 如果这是不可接受的，则应首先将引用与 Box::from_raw 函数包装在一起，生成 Box。

这个 Box 可以被丢弃，这将正确销毁 T 并释放分配的内存。

Note: 这是一个关联函数，这意味着您必须将其称为 Box::leak(b) 而不是 b.leak()。 这样就不会与内部类型的方法发生冲突。

Examples

简单用法:

let x = Box::new(41);
let static_ref: &'static mut usize = Box::leak(x);
*static_ref += 1;
assert_eq!(*static_ref, 42);

未定义大小的数据:

let x = vec![1, 2, 3].into_boxed_slice();
let static_ref = Box::leak(x);
static_ref[0] = 4;
assert_eq!(*static_ref, [4, 2, 3]);

pub fn into_pin(boxed: Self) -> Pin<Self> where
    A: 'static, 

🔬 This is a nightly-only experimental API. (box_into_pin #62370)

将 Box<T> 转换为 Pin<Box<T>>

这种转换不会在堆上分配，而是就地进行。

也可以通过 From 获得。

impl<A: Allocator> Box<dyn Any, A>

pub fn downcast<T: Any>(self) -> Result<Box<T, A>, Self>

尝试将 box 转换为具体类型。

Examples

use std::any::Any;

fn print_if_string(value: Box<dyn Any>) {
    if let Ok(string) = value.downcast::<String>() {
        println!("String ({}): {}", string.len(), string);
    }
}

let my_string = "Hello World".to_string();
print_if_string(Box::new(my_string));
print_if_string(Box::new(0i8));

impl<A: Allocator> Box<dyn Any + Send, A>

pub fn downcast<T: Any>(self) -> Result<Box<T, A>, Self>

尝试将 box 转换为具体类型。

Examples

use std::any::Any;

fn print_if_string(value: Box<dyn Any + Send>) {
    if let Ok(string) = value.downcast::<String>() {
        println!("String ({}): {}", string.len(), string);
    }
}

let my_string = "Hello World".to_string();
print_if_string(Box::new(my_string));
print_if_string(Box::new(0i8));

impl<A: Allocator> Box<dyn Any + Send + Sync, A>

pub fn downcast<T: Any>(self) -> Result<Box<T, A>, Self>

尝试将 box 转换为具体类型。

Examples

use std::any::Any;

fn print_if_string(value: Box<dyn Any + Send + Sync>) {
    if let Ok(string) = value.downcast::<String>() {
        println!("String ({}): {}", string.len(), string);
    }
}

let my_string = "Hello World".to_string();
print_if_string(Box::new(my_string));
print_if_string(Box::new(0i8));

Trait Implementations

impl<T: ?Sized, A: Allocator> AsMut<T> for Box<T, A>

fn as_mut(&mut self) -> &mut T

执行转换。

impl<T: ?Sized, A: Allocator> AsRef<T> for Box<T, A>

fn as_ref(&self) -> &T

执行转换。

impl<T: ?Sized, A: Allocator> Borrow<T> for Box<T, A>

fn borrow(&self) -> &T

从拥有的值中一成不变地借用。

impl<T: ?Sized, A: Allocator> BorrowMut<T> for Box<T, A>

fn borrow_mut(&mut self) -> &mut T

从拥有的值中借用。

impl<T: Clone, A: Allocator + Clone> Clone for Box<T, A>

fn clone(&self) -> Self

返回带有此 box 的 内容的 clone() 的新 box。

Examples

let x = Box::new(5);
let y = x.clone();

// 值是一样的
assert_eq!(x, y);

// 但是它们是独特的对象
assert_ne!(&*x as *const i32, &*y as *const i32);

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

将 source 的内容复制到 self，而不创建新的分配。

Examples

let x = Box::new(5);
let mut y = Box::new(10);
let yp: *const i32 = &*y;

y.clone_from(&x);

// 值是一样的
assert_eq!(x, y);

// 没有分配发生
assert_eq!(yp, &*y);

impl Clone for Box<str>

fn clone(&self) -> Self

返回值的副本。

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

从 source 执行复制分配。

impl<T: Clone, A: Allocator + Clone> Clone for Box<[T], A>

fn clone(&self) -> Self

返回值的副本。

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

从 source 执行复制分配。

impl<T: Debug + ?Sized, A: Allocator> Debug for Box<T, A>

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

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

impl<T: Default> Default for Box<T>

fn default() -> Self

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

impl<T> Default for Box<[T]>

fn default() -> Self

返回类型的 “default value”。

impl Default for Box<str>

fn default() -> Self

返回类型的 “default value”。

impl<T: ?Sized, A: Allocator> Deref for Box<T, A>

type Target = T

解引用后的结果类型。

fn deref(&self) -> &T

解引用值。

impl<T: ?Sized, A: Allocator> DerefMut for Box<T, A>

fn deref_mut(&mut self) -> &mut T

可变地解引用该值。

impl<T: Display + ?Sized, A: Allocator> Display for Box<T, A>

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

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

impl<I: DoubleEndedIterator + ?Sized, A: Allocator> DoubleEndedIterator for Box<I, A>

fn next_back(&mut self) -> Option<I::Item>

从迭代器的末尾删除并返回一个元素。

fn nth_back(&mut self, n: usize) -> Option<I::Item>

从迭代器的末尾返回第 n 个元素。

fn advance_back_by(&mut self, n: usize) -> Result<(), usize>

🔬 This is a nightly-only experimental API. (iter_advance_by #77404)

recently added

通过 n 元素从后向前推进迭代器。

fn try_rfold<B, F, R>(&mut self, init: B, f: F) -> R where
    F: FnMut(B, Self::Item) -> R,
    R: Try<Output = B>, 

这是 Iterator::try_fold() 的反向版本: 它从迭代器的后面开始接收元素。

fn rfold<B, F>(self, init: B, f: F) -> B where
    F: FnMut(B, Self::Item) -> B, 

一种迭代器方法，从后面开始，将迭代器的元素减少为单个最终值。

fn rfind<P>(&mut self, predicate: P) -> Option<Self::Item> where
    P: FnMut(&Self::Item) -> bool, 

从后面搜索满足谓词的迭代器的元素。

impl<T: ?Sized, A: Allocator> Drop for Box<T, A>

fn drop(&mut self)

执行此类型的析构函数。

impl<I: ExactSizeIterator + ?Sized, A: Allocator> ExactSizeIterator for Box<I, A>

fn len(&self) -> usize

返回迭代器的确切长度。

fn is_empty(&self) -> bool

🔬 This is a nightly-only experimental API. (exact_size_is_empty #35428)

如果迭代器为空，则返回 true。

impl Extend<Box<str, Global>> for String

fn extend<I: IntoIterator<Item = Box<str>>>(&mut self, iter: I)

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

fn extend_one(&mut self, item: A)

🔬 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<Args, F: Fn<Args> + ?Sized, A: Allocator> Fn<Args> for Box<F, A>

extern "rust-call" fn call(&self, args: Args) -> Self::Output

🔬 This is a nightly-only experimental API. (fn_traits #29625)

执行调用操作。

impl<Args, F: FnMut<Args> + ?Sized, A: Allocator> FnMut<Args> for Box<F, A>

extern "rust-call" fn call_mut(&mut self, args: Args) -> Self::Output

🔬 This is a nightly-only experimental API. (fn_traits #29625)

执行调用操作。

impl<Args, F: FnOnce<Args> + ?Sized, A: Allocator> FnOnce<Args> for Box<F, A>

type Output = <F as FnOnce<Args>>::Output

使用调用运算符后的返回类型。

extern "rust-call" fn call_once(self, args: Args) -> Self::Output

🔬 This is a nightly-only experimental API. (fn_traits #29625)

执行调用操作。

impl<T: Copy> From<&'_ [T]> for Box<[T]>

fn from(slice: &[T]) -> Box<[T]>

将 &[T] 转换为 Box<[T]>

此转换在堆上分配并执行 slice 的副本。

Examples

// 创建 &[u8] which 将用于创建 Box<[u8]>
let slice: &[u8] = &[104, 101, 108, 108, 111];
let boxed_slice: Box<[u8]> = Box::from(slice);

println!("{:?}", boxed_slice);

impl From<&'_ str> for Box<str>

fn from(s: &str) -> Box<str>

将 &str 转换为 Box<str>

此转换在堆上分配并执行 s 的副本。

Examples

let boxed: Box<str> = Box::from("hello");
println!("{}", boxed);

impl<T, const N: usize> From<[T; N]> for Box<[T]>

fn from(array: [T; N]) -> Box<[T]>

将 [T; N] 转换为 Box<[T]>

此转换将数组移动到新的堆分配的内存中。

Examples

let boxed: Box<[u8]> = Box::from([4, 2]);
println!("{:?}", boxed);

impl<T, A: Allocator> From<Box<[T], A>> for Vec<T, A>

fn from(s: Box<[T], A>) -> Self

通过转移现有堆分配的所有权，将 boxed 切片转换为 vector。

Examples

let b: Box<[i32]> = vec![1, 2, 3].into_boxed_slice();
assert_eq!(Vec::from(b), vec![1, 2, 3]);

impl<T: ?Sized, A: Allocator> From<Box<T, A>> for Pin<Box<T, A>> where
    A: 'static, 

fn from(boxed: Box<T, A>) -> Self

将 Box<T> 转换为 Pin<Box<T>>

这种转换不会在堆上分配，而是就地进行。

impl<T: ?Sized> From<Box<T, Global>> for Rc<T>

fn from(v: Box<T>) -> Rc<T>

将 boxed 对象移动到引用计数的新分配。

Example

let original: Box<i32> = Box::new(1);
let shared: Rc<i32> = Rc::from(original);
assert_eq!(1, *shared);

impl<T: ?Sized> From<Box<T, Global>> for Arc<T>

fn from(v: Box<T>) -> Arc<T>

将 boxed 对象移动到新的引用计数分配。

Example

let unique: Box<str> = Box::from("eggplant");
let shared: Arc<str> = Arc::from(unique);
assert_eq!("eggplant", &shared[..]);

impl<A: Allocator> From<Box<str, A>> for Box<[u8], A>

fn from(s: Box<str, A>) -> Self

将 Box<str> 转换为 Box<[u8]>

这种转换不会在堆上分配，而是就地进行。

Examples

// 创建一个 Box<str>，该 Box<str> 将用于创建 Box<[u8]>
let boxed: Box<str> = Box::from("hello");
let boxed_str: Box<[u8]> = Box::from(boxed);

// 创建 &[u8] which 将用于创建 Box<[u8]>
let slice: &[u8] = &[104, 101, 108, 108, 111];
let boxed_slice = Box::from(slice);

assert_eq!(boxed_slice, boxed_str);

impl From<Box<str, Global>> for String

fn from(s: Box<str>) -> String

将给定的 boxed str 切片转换为 String。 值得注意的是，str 切片是拥有的。

Examples

基本用法:

let s1: String = String::from("hello world");
let s2: Box<str> = s1.into_boxed_str();
let s3: String = String::from(s2);

assert_eq!("hello world", s3)

impl<T: Copy> From<Cow<'_, [T]>> for Box<[T]>

fn from(cow: Cow<'_, [T]>) -> Box<[T]>

执行转换。

impl From<Cow<'_, str>> for Box<str>

fn from(cow: Cow<'_, str>) -> Box<str>

执行转换。

impl From<String> for Box<str>

fn from(s: String) -> Box<str>

将给定的 String 转换为拥有所有权的 boxed str 切片。

Examples

基本用法:

let s1: String = String::from("hello world");
let s2: Box<str> = Box::from(s1);
let s3: String = String::from(s2);

assert_eq!("hello world", s3)

impl<T> From<T> for Box<T>

fn from(t: T) -> Self

将 T 转换为 Box<T>

转换在堆上分配，并将 t 从栈移到堆中。

Examples

let x = 5;
let boxed = Box::new(5);

assert_eq!(Box::from(x), boxed);

impl<T, A: Allocator> From<Vec<T, A>> for Box<[T], A>

fn from(v: Vec<T, A>) -> Self

将 vector 转换为 boxed。

如果 v 有多余的容量，它的项将被移动到新分配的缓冲区中，缓冲区的容量恰好是正确的。

Examples

assert_eq!(Box::from(vec![1, 2, 3]), vec![1, 2, 3].into_boxed_slice());

impl FromIterator<Box<str, Global>> for String

fn from_iter<I: IntoIterator<Item = Box<str>>>(iter: I) -> String

从迭代器创建一个值。

impl<I> FromIterator<I> for Box<[I]>

fn from_iter<T: IntoIterator<Item = I>>(iter: T) -> Self

从迭代器创建一个值。

impl<F: ?Sized + Future + Unpin, A: Allocator> Future for Box<F, A> where
    A: 'static, 

type Output = F::Output

完成时产生的值类型。

fn poll(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Self::Output>

尝试将 future 解析为最终值，如果该值尚不可用，请注册当前任务以进行唤醒。

impl<G: ?Sized + Generator<R> + Unpin, R, A: Allocator> Generator<R> for Box<G, A> where
    A: 'static, 

type Yield = G::Yield

🔬 This is a nightly-only experimental API. (generator_trait #43122)

此生成器产生的值的类型。

type Return = G::Return

🔬 This is a nightly-only experimental API. (generator_trait #43122)

此生成器返回的值的类型。

fn resume(
    self: Pin<&mut Self>,
    arg: R
) -> GeneratorState<Self::Yield, Self::Return>

🔬 This is a nightly-only experimental API. (generator_trait #43122)

恢复此生成器的执行。

impl<T: ?Sized + Hash, A: Allocator> Hash for Box<T, A>

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

将该值输入给定的 Hasher。

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

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

impl<T: ?Sized + Hasher, A: Allocator> Hasher for Box<T, A>

fn finish(&self) -> u64

返回到目前为止写入的值的哈希值。

fn write(&mut self, bytes: &[u8])

将一些数据写入此 Hasher。

fn write_u8(&mut self, i: u8)

将单个 u8 写入此哈希器。

fn write_u16(&mut self, i: u16)

将单个 u16 写入此哈希器。

fn write_u32(&mut self, i: u32)

将单个 u32 写入此哈希器。

fn write_u64(&mut self, i: u64)

将单个 u64 写入此哈希器。

fn write_u128(&mut self, i: u128)

将单个 u128 写入此哈希器。

fn write_usize(&mut self, i: usize)

将单个 usize 写入此哈希器。

fn write_i8(&mut self, i: i8)

将单个 i8 写入此哈希器。

fn write_i16(&mut self, i: i16)

将单个 i16 写入此哈希器。

fn write_i32(&mut self, i: i32)

将单个 i32 写入此哈希器。

fn write_i64(&mut self, i: i64)

将单个 i64 写入此哈希器。

fn write_i128(&mut self, i: i128)

将单个 i128 写入此哈希器。

fn write_isize(&mut self, i: isize)

将单个 isize 写入此哈希器。

impl<I: Iterator + ?Sized, A: Allocator> Iterator for Box<I, A>

type Item = I::Item

被迭代的元素的类型。

fn next(&mut self) -> Option<I::Item>

推进迭代器并返回下一个值。

fn size_hint(&self) -> (usize, Option<usize>)

返回迭代器剩余长度的界限。

fn nth(&mut self, n: usize) -> Option<I::Item>

返回迭代器的第 n 个元素。

fn last(self) -> Option<I::Item>

使用迭代器，返回最后一个元素。

fn count(self) -> usize

使用迭代器，计算迭代次数并返回它。

fn advance_by(&mut self, n: usize) -> Result<(), usize>

🔬 This is a nightly-only experimental API. (iter_advance_by #77404)

recently added

通过 n 元素使迭代器前进。

fn step_by(self, step: usize) -> StepBy<Self>

创建一个从同一点开始的迭代器，但在每次迭代时以给定的数量逐步执行。

fn chain<U>(self, other: U) -> Chain<Self, <U as IntoIterator>::IntoIter> where
    U: IntoIterator<Item = Self::Item>, 

接受两个迭代器，并依次在两个迭代器上创建一个新的迭代器。

fn zip<U>(self, other: U) -> Zip<Self, <U as IntoIterator>::IntoIter> where
    U: IntoIterator, 

将两个迭代器压缩为成对的单个迭代器。

fn intersperse(self, separator: Self::Item) -> Intersperse<Self> where
    Self::Item: Clone, 

🔬 This is a nightly-only experimental API. (iter_intersperse #79524)

recently added

创建一个新的迭代器，该迭代器将 separator 的副本放置在原始迭代器的相邻项之间。

fn intersperse_with<G>(self, separator: G) -> IntersperseWith<Self, G> where
    G: FnMut() -> Self::Item, 

🔬 This is a nightly-only experimental API. (iter_intersperse #79524)

recently added

创建一个新的迭代器，该迭代器将 separator 生成的项放在原始迭代器的相邻项之间。

fn map<B, F>(self, f: F) -> Map<Self, F> where
    F: FnMut(Self::Item) -> B, 

获取一个闭包并创建一个迭代器，该迭代器在每个元素上调用该闭包。

fn for_each<F>(self, f: F) where
    F: FnMut(Self::Item), 

在迭代器的每个元素上调用一个闭包。

fn filter<P>(self, predicate: P) -> Filter<Self, P> where
    P: FnMut(&Self::Item) -> bool, 

创建一个迭代器，该迭代器使用闭包确定是否应产生元素。

fn filter_map<B, F>(self, f: F) -> FilterMap<Self, F> where
    F: FnMut(Self::Item) -> Option<B>, 

创建一个同时过滤和 maps 的迭代器。

fn enumerate(self) -> Enumerate<Self>

创建一个迭代器，该迭代器给出当前迭代次数以及下一个值。

fn peekable(self) -> Peekable<Self>

创建一个迭代器，它可以使用 peek 和 peek_mut 方法查看迭代器的下一个元素而不消耗它。有关更多信息，请参见他们的文档。

fn skip_while<P>(self, predicate: P) -> SkipWhile<Self, P> where
    P: FnMut(&Self::Item) -> bool, 

创建一个迭代器，该迭代器基于谓词 skip 个元素。

fn take_while<P>(self, predicate: P) -> TakeWhile<Self, P> where
    P: FnMut(&Self::Item) -> bool, 

创建一个迭代器，该迭代器根据谓词产生元素。

fn map_while<B, P>(self, predicate: P) -> MapWhile<Self, P> where
    P: FnMut(Self::Item) -> Option<B>, 

🔬 This is a nightly-only experimental API. (iter_map_while #68537)

recently added

创建一个迭代器，该迭代器均基于谓词和 maps 产生元素。

fn skip(self, n: usize) -> Skip<Self>

创建一个跳过前 n 个元素的迭代器。

fn take(self, n: usize) -> Take<Self>

创建一个迭代器，它产生第一个 n 元素，如果底层迭代器提前结束，则产生更少的元素。

fn scan<St, B, F>(self, initial_state: St, f: F) -> Scan<Self, St, F> where
    F: FnMut(&mut St, Self::Item) -> Option<B>, 

与 fold 相似的迭代器适配器，它保持内部状态并生成新的迭代器。

fn flat_map<U, F>(self, f: F) -> FlatMap<Self, U, F> where
    F: FnMut(Self::Item) -> U,
    U: IntoIterator, 

创建一个迭代器，其工作方式类似于 map，但是将嵌套的结构展平。

fn flatten(self) -> Flatten<Self> where
    Self::Item: IntoIterator, 

创建一个可简化嵌套结构体的迭代器。

fn fuse(self) -> Fuse<Self>

创建一个迭代器，该迭代器在第一个 None 之后结束。

fn inspect<F>(self, f: F) -> Inspect<Self, F> where
    F: FnMut(&Self::Item), 

对迭代器的每个元素执行某些操作，将值传递给它。

fn by_ref(&mut self) -> &mut Self

借用一个迭代器，而不是使用它。

#[must_use = "if you really need to exhaust the iterator, consider `.for_each(drop)` instead"]

fn collect<B>(self) -> B where
    B: FromIterator<Self::Item>, 

将迭代器转换为集合。

fn partition<B, F>(self, f: F) -> (B, B) where
    F: FnMut(&Self::Item) -> bool,
    B: Default + Extend<Self::Item>, 

使用一个迭代器，从中创建两个集合。

fn partition_in_place<'a, T, P>(self, predicate: P) -> usize where
    Self: DoubleEndedIterator<Item = &'a mut T>,
    T: 'a,
    P: FnMut(&T) -> bool, 

🔬 This is a nightly-only experimental API. (iter_partition_in_place #62543)

new API

根据给定的谓词，对迭代器的元素进行就地重新排序，以使所有返回 true 的元素都在所有返回 false 的元素之前。 返回找到的 true 元素的数量。

fn is_partitioned<P>(self, predicate: P) -> bool where
    P: FnMut(Self::Item) -> bool, 

🔬 This is a nightly-only experimental API. (iter_is_partitioned #62544)

new API

检查此迭代器的元素是否根据给定的谓词进行了分区，以便所有返回 true 的元素都在所有返回 false 的元素之前。

fn try_fold<B, F, R>(&mut self, init: B, f: F) -> R where
    F: FnMut(B, Self::Item) -> R,
    R: Try<Output = B>, 

一个迭代器方法，它只要成功返回就应用函数，并产生单个最终值。

fn try_for_each<F, R>(&mut self, f: F) -> R where
    F: FnMut(Self::Item) -> R,
    R: Try<Output = ()>, 

一个迭代器方法，该方法将一个容易犯错的函数应用于迭代器中的每个项，在第一个错误处停止并返回该错误。

fn fold<B, F>(self, init: B, f: F) -> B where
    F: FnMut(B, Self::Item) -> B, 

通过应用操作将每个元素 fold 到一个累加器中，返回最终结果。

fn reduce<F>(self, f: F) -> Option<Self::Item> where
    F: FnMut(Self::Item, Self::Item) -> Self::Item, 

通过重复应用归约运算，将元素缩减为一个。

fn all<F>(&mut self, f: F) -> bool where
    F: FnMut(Self::Item) -> bool, 

测试迭代器的每个元素是否与谓词匹配。

fn any<F>(&mut self, f: F) -> bool where
    F: FnMut(Self::Item) -> bool, 

测试迭代器的任何元素是否与谓词匹配。

fn find<P>(&mut self, predicate: P) -> Option<Self::Item> where
    P: FnMut(&Self::Item) -> bool, 

搜索满足谓词的迭代器的元素。

fn find_map<B, F>(&mut self, f: F) -> Option<B> where
    F: FnMut(Self::Item) -> Option<B>, 

将函数应用于迭代器的元素，并返回第一个非无结果。

fn try_find<F, R, E>(&mut self, f: F) -> Result<Option<Self::Item>, E> where
    F: FnMut(&Self::Item) -> R,
    R: Try<Output = bool, Residual = Result<Infallible, E>> + Try, 

🔬 This is a nightly-only experimental API. (try_find #63178)

new API

将函数应用于迭代器的元素，并返回第一个真结果或第一个错误。

fn position<P>(&mut self, predicate: P) -> Option<usize> where
    P: FnMut(Self::Item) -> bool, 

在迭代器中搜索元素，并返回其索引。

fn rposition<P>(&mut self, predicate: P) -> Option<usize> where
    Self: ExactSizeIterator + DoubleEndedIterator,
    P: FnMut(Self::Item) -> bool, 

从右侧搜索迭代器中的元素，并返回其索引。

fn max(self) -> Option<Self::Item> where
    Self::Item: Ord, 

返回迭代器的最大元素。

fn min(self) -> Option<Self::Item> where
    Self::Item: Ord, 

返回迭代器的最小元素。

fn max_by_key<B, F>(self, f: F) -> Option<Self::Item> where
    F: FnMut(&Self::Item) -> B,
    B: Ord, 

返回给出指定函数最大值的元素。

fn max_by<F>(self, compare: F) -> Option<Self::Item> where
    F: FnMut(&Self::Item, &Self::Item) -> Ordering, 

返回给出相对于指定比较函数的最大值的元素。

fn min_by_key<B, F>(self, f: F) -> Option<Self::Item> where
    F: FnMut(&Self::Item) -> B,
    B: Ord, 

返回给出指定函数中最小值的元素。

fn min_by<F>(self, compare: F) -> Option<Self::Item> where
    F: FnMut(&Self::Item, &Self::Item) -> Ordering, 

返回给出相对于指定比较函数的最小值的元素。

fn rev(self) -> Rev<Self> where
    Self: DoubleEndedIterator, 

反转迭代器的方向。

fn unzip<A, B, FromA, FromB>(self) -> (FromA, FromB) where
    Self: Iterator<Item = (A, B)>,
    FromA: Default + Extend<A>,
    FromB: Default + Extend<B>, 

将成对的迭代器转换为一对容器。

fn copied<'a, T>(self) -> Copied<Self> where
    Self: Iterator<Item = &'a T>,
    T: 'a + Copy, 

创建一个迭代器，该迭代器将复制其所有元素。

fn cloned<'a, T>(self) -> Cloned<Self> where
    Self: Iterator<Item = &'a T>,
    T: 'a + Clone, 

创建一个迭代器，该迭代器将克隆所有元素。

fn cycle(self) -> Cycle<Self> where
    Self: Clone, 

不断重复的迭代器。

fn sum<S>(self) -> S where
    S: Sum<Self::Item>, 

对迭代器的元素求和。

fn product<P>(self) -> P where
    P: Product<Self::Item>, 

遍历整个迭代器，将所有元素相乘

fn cmp<I>(self, other: I) -> Ordering where
    I: IntoIterator<Item = Self::Item>,
    Self::Item: Ord, 

Lexicographically 将此 Iterator 的元素与另一个元素进行比较。

fn cmp_by<I, F>(self, other: I, cmp: F) -> Ordering where
    I: IntoIterator,
    F: FnMut(Self::Item, <I as IntoIterator>::Item) -> Ordering, 

🔬 This is a nightly-only experimental API. (iter_order_by #64295)

Lexicographically 就指定的比较函数而言，将此 Iterator 的元素与另一个元素进行比较。

fn partial_cmp<I>(self, other: I) -> Option<Ordering> where
    I: IntoIterator,
    Self::Item: PartialOrd<<I as IntoIterator>::Item>, 

Lexicographically 将此 Iterator 的元素与另一个元素进行比较。

fn partial_cmp_by<I, F>(self, other: I, partial_cmp: F) -> Option<Ordering> where
    I: IntoIterator,
    F: FnMut(Self::Item, <I as IntoIterator>::Item) -> Option<Ordering>, 

🔬 This is a nightly-only experimental API. (iter_order_by #64295)

Lexicographically 就指定的比较函数而言，将此 Iterator 的元素与另一个元素进行比较。

fn eq<I>(self, other: I) -> bool where
    I: IntoIterator,
    Self::Item: PartialEq<<I as IntoIterator>::Item>, 

确定此 Iterator 的元素是否与另一个元素相同。

fn eq_by<I, F>(self, other: I, eq: F) -> bool where
    I: IntoIterator,
    F: FnMut(Self::Item, <I as IntoIterator>::Item) -> bool, 

🔬 This is a nightly-only experimental API. (iter_order_by #64295)

关于指定的相等函数，确定 Iterator 的元素是否与另一个元素相等。

fn ne<I>(self, other: I) -> bool where
    I: IntoIterator,
    Self::Item: PartialEq<<I as IntoIterator>::Item>, 

确定此 Iterator 的元素是否与另一个元素不相等。

fn lt<I>(self, other: I) -> bool where
    I: IntoIterator,
    Self::Item: PartialOrd<<I as IntoIterator>::Item>, 

确定此 Iterator 的元素是否比另一个元素少 按字典顺序。

fn le<I>(self, other: I) -> bool where
    I: IntoIterator,
    Self::Item: PartialOrd<<I as IntoIterator>::Item>, 

确定此 Iterator 的元素是否 按字典顺序 小于或等于另一个元素。

fn gt<I>(self, other: I) -> bool where
    I: IntoIterator,
    Self::Item: PartialOrd<<I as IntoIterator>::Item>, 

确定此 Iterator 的元素是否大于另一个元素的 按字典顺序。

fn ge<I>(self, other: I) -> bool where
    I: IntoIterator,
    Self::Item: PartialOrd<<I as IntoIterator>::Item>, 

确定此 Iterator 的元素是否 按字典顺序 大于或等于另一个元素。

fn is_sorted(self) -> bool where
    Self::Item: PartialOrd<Self::Item>, 

🔬 This is a nightly-only experimental API. (is_sorted #53485)

new API

检查此迭代器的元素是否已排序。

fn is_sorted_by<F>(self, compare: F) -> bool where
    F: FnMut(&Self::Item, &Self::Item) -> Option<Ordering>, 

🔬 This is a nightly-only experimental API. (is_sorted #53485)

new API

检查此迭代器的元素是否使用给定的比较器函数进行排序。

fn is_sorted_by_key<F, K>(self, f: F) -> bool where
    F: FnMut(Self::Item) -> K,
    K: PartialOrd<K>, 

🔬 This is a nightly-only experimental API. (is_sorted #53485)

new API

检查此迭代器的元素是否使用给定的键提取函数进行排序。

impl<T: ?Sized + Ord, A: Allocator> Ord for Box<T, A>

fn cmp(&self, other: &Self) -> 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<T: ?Sized + PartialEq, A: Allocator> PartialEq<Box<T, A>> for Box<T, A>

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

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

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

此方法测试 !=。

impl<T: ?Sized + PartialOrd, A: Allocator> PartialOrd<Box<T, A>> for Box<T, A>

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

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

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

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

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

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

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

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

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

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

impl<T: ?Sized, A: Allocator> Pointer for Box<T, A>

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

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

impl<S: ?Sized + Stream + Unpin> Stream for Box<S>

type Item = S::Item

🔬 This is a nightly-only experimental API. (async_stream #79024)

流产生的项的类型。

fn poll_next(
    self: Pin<&mut Self>,
    cx: &mut Context<'_>
) -> Poll<Option<Self::Item>>

🔬 This is a nightly-only experimental API. (async_stream #79024)

尝试拉出该流的下一个值，如果该值尚不可用，则注册当前任务以进行唤醒，如果流已用尽，则返回 None。

fn size_hint(&self) -> (usize, Option<usize>)

🔬 This is a nightly-only experimental API. (async_stream #79024)

返回流剩余长度上的边界。

impl<T, const N: usize> TryFrom<Box<[T], Global>> for Box<[T; N]>

type Error = Box<[T]>

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

fn try_from(boxed_slice: Box<[T]>) -> Result<Self, Self::Error>

执行转换。

impl<T: ?Sized + Unsize<U>, U: ?Sized, A: Allocator> CoerceUnsized<Box<U, A>> for Box<T, A>

impl<T: ?Sized + Unsize<U>, U: ?Sized> DispatchFromDyn<Box<U, Global>> for Box<T, Global>

impl<T: ?Sized + Eq, A: Allocator> Eq for Box<T, A>

impl<I: FusedIterator + ?Sized, A: Allocator> FusedIterator for Box<I, A>

impl<T: ?Sized, A: Allocator> Receiver for Box<T, A>

impl<T: ?Sized, A: Allocator> Unpin for Box<T, A> where
    A: 'static,