Function find_keep

pub const fn find_keep<'a>(this: &'a str, needle: &str) -> Option<&'a str>

Advances this up to the first instance of needle.

Return None if no instance of needle is found.

Return Some(this) if needle is empty.

Motivation

This function exists because calling find + str_from when the "rust_1_64" feature is disabled is slower than it could be, since the slice has to be traversed twice.

Example

use konst::string;

{
    const FOUND: Option<&str> = string::find_keep("foo bar baz", "bar");
    assert_eq!(FOUND, Some("bar baz"));
}
{
    const NOT_FOUND: Option<&str> = string::find_keep("foo bar baz", "qux");
    assert_eq!(NOT_FOUND, None);
}
{
    const EMPTY_NEEDLE: Option<&str> = string::find_keep("foo bar baz", "");
    assert_eq!(EMPTY_NEEDLE, Some("foo bar baz"));
}