Spec-Zone.ru › C++

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

constexpr bool
    ends_with( std::basic_string_view<CharT, Traits> sv ) const noexcept;
(1) (начиная с C++20)
constexpr bool
    ends_with( CharT ch ) const noexcept;
(2) (начиная с C++20)
constexpr bool
    ends_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()).ends_with(x), где x — параметр.

Параметры

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

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

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

Примечания

Макрос проверки возможностей Значение Стандарт Возможность
__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.ends_with("C++20!"sv)  // (1)
        && !str.ends_with("c++20!"sv) // (1)
        && str.ends_with("C++20!"s)   // (1) implicit conversion string to string_view
        && !str.ends_with("c++20!"s)  // (1) implicit conversion string to string_view
        && str.ends_with('!')         // (2)
        && !str.ends_with('?')        // (2)
        && str.ends_with("C++20!")    // (3)
        && !str.ends_with("c++20!")   // (3)
    );
}

См. также

starts_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/cpp/string/basic_string/ends_with

Spec-Zone.ru

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