Rust String.try_reserve用法及代码示例

本文简要介绍rust语言中 std::string::String.try_reserve 的用法。

用法

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

尝试为至少 additional 更多要插入给定 String 的元素保留容量。集合可以保留更多空间以避免频繁的重新分配。调用 reserve 后，容量将大于或等于 self.len() + additional 。如果容量已经足够，则什么也不做。

错误

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

例子

use std::collections::TryReserveError;

fn process_data(data: &str) -> Result<String, TryReserveError> {
    let mut output = String::new();

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

    // Now we know this can't OOM in the middle of our complex work
    output.push_str(data);

    Ok(output)
}

相关用法

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