Tracking Issue for `byte_search`

Feature gate: #![feature(byte_search)]
acp: https://github.com/rust-lang/libs-team/issues/499

This is a tracking issue for byte searching: searching for a particular pattern of bytes in a &[u8], and potentially trimming, splitting or otherwise processing the input based on the matches of the pattern.

Public API

The API mirrors the one for strings at std::str::pattern::Pattern.

pub trait BytePattern: Sized {
    /// Associated searcher for this pattern
    type Searcher<'a>: Searcher<'a>;

    // etc.
}

and then adds a number of inherent methods for &[u8]. The exact set has not yet been decided, but will likely include (modulo slight naming changes):

• contains_bytes
• find_bytes
• rfind_bytes
• split_bytes
• rsplit_bytes
• split_bytes_once
• rsplit_bytes
• splitn_bytes
• rsplitn_bytes
• replace_bytes
• replacen_bytes
• starts_with_bytes
• ends_with_bytes
• matches_bytes
• rmatches_bytes
• match_indices_bytes
• rmatch_indices_bytes
• trim_bytes_start_matches
• trim_bytes_end_matches
• strip_bytes_prefix
• strip_bytes_suffix

Steps / History

• ACP: https://github.com/rust-lang/libs-team/issues/499#issuecomment-2532563916, https://github.com/rust-lang/libs-team/issues/311
• Implementation: #...
• Final comment period (FCP)^1
• Stabilization PR

Unresolved Questions

• None yet.

Start with the ACP links and the public API section, including std::str::pattern::Pattern and the proposed byte-search methods. Review the feature-gate and implementation checklist; this issue is complete only after the API and implementation are decided, followed by FCP and a stabilization PR.