Spec-Zone.ru › C++

std::basic_string_view<CharT,Traits>::starts_with

constexpr bool starts_with( basic_string_view 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) префикс — строковый фрагмент. Эффективно возвращает basic_string_view(data(), std::min(size(), x.size())) == sv.
2) префикс — один символ. Эффективно возвращает !empty() && Traits::eq(front(), ch).
3) префикс — строка символов с нулевым завершением. Эффективно возвращает starts_with(basic_string_view(s)).

Параметры

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

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

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

Примечания

Макро-тест функции Значение Стандарт Функция
__cpp_lib_starts_ends_with 201711L (C++20) Проверка префикса и суффикса строк: starts_with() и ends_with()

Пример

#include <cassert>
#include <string_view>
 
int main()
{
    using namespace std::literals;
 
    assert
    (""
        // (1) starts_with( basic_string_view )
        && "https://cppreference.com"sv.starts_with("http"sv) == true
        && "https://cppreference.com"sv.starts_with("ftp"sv) == false
 
        // (2) starts_with( CharT )
        && "C++20"sv.starts_with('C') == true
        && "C++20"sv.starts_with('J') == false
 
        // (3) starts_with( const CharT* )
        && std::string_view("string_view").starts_with("string") == true
        && std::string_view("string_view").starts_with("String") == false
    );
}

См. также

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

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API