Vec::with_capacity

pub static fn with_capacity(int n) -> Vec<T>

Creates an empty vector with room for at least n elements.

Pushing up to n elements does not reallocate. The length is still 0.

Parameters#

Returns#

Vec<T>

Examples#

use tests::assert;
let v: Vec<int> = Vec::with_capacity(16);
assert!(v.len() == 0);
assert!(v.capacity() >= 16);

See also#

• Vec: A growable, heap-allocated vector of T values.
• Vec::new: Creates a new, empty vector.
• Vec::from: Creates a vector holding a copy of the elements of the fixed array arr.
• Vec::push: Appends x to the end of the vector.
• Vec::pop: Removes the last element and returns it, or None when the vector is empty.
• Vec::insert: Inserts x at index i, shifting later elements one place to the right.
• Vec::remove: Removes the element at index i and returns it, shifting later elements left.
• Vec::clear: Removes every element.