std::basic_string<CharT,Traits,Allocator>::starts_with

constexpr bool starts_with( std::basic_string_view<CharT,Traits> sv ) const noexcept;	(1)	(с C++20)
constexpr bool starts_with( CharT ch ) const noexcept;	(2)	(с C++20)
constexpr bool starts_with( const CharT* s ) const;	(3)	(с C++20)

Проверяет, начинается ли строка с заданного префикса. Префикс может быть одним из следующих:

1) Строковый вид sv (который может быть результатом неявного преобразования из другого std::basic_string).

2) Один символ ch.

3) Нуль-терминированная строка символов s.

Все три перегрузки фактически возвращают std::basic_string_view<CharT, Traits>(data(), size()).starts_with(x), где x — это параметр.

Параметры

sv	-	строковый вид, который может быть результатом неявного преобразования из другого `std::basic_string`
ch	-	одиночный символ
s	-	нуль-терминированная строка символов

Возвращаемое значение

true если строка начинается с указанного префикса, false в противном случае.

Примечания

Макроинструкция проверки возможности	Значение	Std	Функция
`__cpp_lib_starts_ends_with`	201711L	(C++20)	Проверка префикса и суффикса строки: `starts_with()` и `ends_with()`

Пример

#include <cassert>
#include <string>
#include <string_view>
 
int main()
{
    using namespace std::literals;
 
    const auto str = "Hello, C++20!"s;
 
    assert
    (""
        && str.starts_with("He"sv)  // (1)
        && !str.starts_with("he"sv) // (1)
        && str.starts_with("He"s)   // (1) implicit conversion string to string_view
        && !str.starts_with("he"s)  // (1) implicit conversion string to string_view
        && str.starts_with('H')     // (2)
        && !str.starts_with('h')    // (2)
        && str.starts_with("He")    // (3)
        && !str.starts_with("he")   // (3)
    );
}

См. также

ends_with (C++20)	проверяет, заканчивается ли строка заданным суффиксом (публичный член-функция)
starts_with (C++20)	проверяет, начинается ли строковый вид с заданным префиксом (публичный член-функция `std::basic_string_view<CharT,Traits>`)
ends_with (C++20)	проверяет, заканчивается ли строковый вид заданным суффиксом (публичный член-функция `std::basic_string_view<CharT,Traits>`)
contains (C++23)	проверяет, содержит ли строка заданную подстроку или символ (публичный член-функция)
contains (C++23)	проверяет, содержит ли строковый вид заданную подстроку или символ (публичный член-функция `std::basic_string_view<CharT,Traits>`)
compare	сравнивает две строки (публичный член-функция)
substr	возвращает подстроку (публичный член-функция)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/string/basic_string/starts_with