本文简要介绍rust语言中 std::string::String.try_reserve_exact
的用法。
用法
pub fn try_reserve_exact( &mut self, additional: usize) -> Result<(), TryReserveError>
尝试为要在给定的 String
中插入的确切 additional
更多元素保留最小容量,在调用 reserve_exact
后,容量将大于或等于 self.len() + additional
。如果容量已经足够,则什么也不做。
请注意,分配器可能会为集合提供比其请求更多的空间。因此,不能依赖容量精确到最小。如果预计将来会插入,则首选 reserve
。
错误
如果容量溢出,或者分配器报告失败,则返回错误。
例子
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 String.try_reserve用法及代码示例
- Rust String.truncate用法及代码示例
- Rust String.insert_str用法及代码示例
- Rust String.into_raw_parts用法及代码示例
- Rust String.extend_from_within用法及代码示例
- Rust String.clear用法及代码示例
- Rust String.reserve用法及代码示例
- Rust String.from_utf16_lossy用法及代码示例
- Rust String.push用法及代码示例
- Rust String.as_bytes用法及代码示例
- Rust String.as_str用法及代码示例
- Rust String.with_capacity用法及代码示例
- Rust String.remove用法及代码示例
- Rust String.from_utf8_lossy用法及代码示例
- Rust String.into_bytes用法及代码示例
- Rust String.replace_range用法及代码示例
- Rust String.split_off用法及代码示例
- Rust String.from_utf16用法及代码示例
- Rust String.shrink_to_fit用法及代码示例
- Rust String.from_utf8_unchecked用法及代码示例
- Rust String.into_boxed_str用法及代码示例
- Rust String.new用法及代码示例
- Rust String.insert用法及代码示例
- Rust String.capacity用法及代码示例
- Rust String.as_mut_str用法及代码示例
注:本文由纯净天空筛选整理自rust-lang.org大神的英文原创作品 std::string::String.try_reserve_exact。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。