Rust VecDeque.try_reserve_exact用法及代码示例

本文简要介绍rust语言中 std::collections::VecDeque.try_reserve_exact 的用法。

用法

pub fn try_reserve_exact(    &mut self,     additional: usize) -> Result<(), TryReserveError>

尝试为要在给定的 VecDeque<T> 中插入的确切 additional 更多元素保留最小容量，在调用 try_reserve_exact 后，容量将大于或等于 self.len() + additional 。如果容量已经足够，则什么也不做。

请注意，分配器可能会为集合提供比其请求更多的空间。因此，不能依赖容量精确到最小。如果预计将来会插入，则首选 reserve 。

错误

如果容量溢出 usize ，或者分配器报告失败，则返回错误。

例子

use std::collections::TryReserveError;
use std::collections::VecDeque;

fn process_data(data: &[u32]) -> Result<VecDeque<u32>, TryReserveError> {
    let mut output = VecDeque::new();

    // Pre-reserve the memory, exiting if we can't
    output.try_reserve_exact(data.len())?;

    // Now we know this can't OOM(Out-Of-Memory) in the middle of our complex work
    output.extend(data.iter().map(|&val| {
        val * 2 + 5 // very complicated
    }));

    Ok(output)
}

相关用法

注：本文由纯净天空筛选整理自rust-lang.org大神的英文原创作品 std::collections::VecDeque.try_reserve_exact。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。