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。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。