Rust String.with_capacity用法及代码示例

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

用法

pub fn with_capacity(capacity: usize) -> String

创建具有特定容量的新空String。

String 有一个内部缓冲区来保存它们的数据。容量是该缓冲区的长度，可以使用 capacity 方法查询。此方法创建一个空的 String ，但具有一个可以保存 capacity 字节的初始缓冲区。当您可能将一堆数据附加到 String 时，这很有用，从而减少了它需要执行的重新分配次数。

如果给定的容量是 0 ，则不会发生分配，此方法与 new 方法相同。

例子

基本用法：

let mut s = String::with_capacity(10);

// The String contains no chars, even though it has capacity for more
assert_eq!(s.len(), 0);

// These are all done without reallocating...
let cap = s.capacity();
for _ in 0..10 {
    s.push('a');
}

assert_eq!(s.capacity(), cap);

// ...but this may make the string reallocate
s.push('a');

相关用法

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