Tracking Issue for Vec::try_shrink_to*

[BitSyndicate1]

Feature gate: #![feature(vec_fallible_shrink)]

This is a tracking issue for implementing fallible shrink methods on Vec so that they may be used in contexts without global OOM handling.

Public API

// alloc::vec

impl Vec {
    pub fn try_shrink_to(&mut self, min_capacity: usize) -> Result<(), TryReserveError>;
    pub fn try_shrink_to_fit(&mut self) -> Result<(), TryReserveError>;
}

Steps / History

• ACP: Adding fallible shrinking to vec using try_shrink_to and try_shrink_to_fit libs-team#728
• Implementation: Add try_shrink_to and try_shrink_to_fit to Vec #152366
• Final comment period (FCP)¹
• Stabilization PR

Unresolved Questions

• Should this use AllocError or TryReserveError?

• None yet.

Footnotes

1. https://std-dev-guide.rust-lang.org/feature-lifecycle/stabilization.html ↩