当前位置: 首页>>代码示例 >>用法及示例精选 >>正文


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。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。