Feature gate: #![feature(trim_prefix_suffix)]

This is a tracking issue for adding trim_prefix and trim_suffix methods to str that remove at most one occurrence of a specified prefix or suffix while always returning a string slice (rather than Option<&str>), enabling easy method chaining.¹

Public API

impl str {
    pub fn trim_prefix<P>(&self, prefix: P) -> &str
    where
        P: Pattern;
    pub fn trim_suffix<P>(&self, suffix: P) -> &str
    where
        P: Pattern,
        for<'a> P::Searcher<'a>: ReverseSearcher<'a>;
}
impl [T] {
    pub fn trim_prefix<P>(&self, prefix: &P) -> &[T]
    where
        P: SlicePattern<Item = T> + ?Sized,
        T: PartialEq;
    pub fn trim_suffix<P>(&self, suffix: &P) -> &[T]
    where
        P: SlicePattern<Item = T> + ?Sized,
        T: PartialEq;
}
impl Path {
    pub fn trim_prefix<P>(&self, base: P) -> &Path
    where
        P: AsRef<Path>;
}

Steps / History

(Remember to update the S-tracking-* label when checking boxes.)

Implementation: Add trim_prefix and trim_suffix methods for both slice and str types. #142331
Final comment period (FCP)²
Stabilization PR

Unresolved Questions

None yet.

Public API

Steps / History

Unresolved Questions

Footnotes