Namensräume
Varianten
Aktionen

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

Von cppreference.com
< cpp‎ | string‎ | basic string
 
 
 
std::basic_string
 
constexpr bool
    ends_with( std::basic_string_view<CharT, Traits> sv ) const noexcept;
(1) (seit C++20)
constexpr bool
    ends_with( CharT ch ) const noexcept;
(2) (seit C++20)
constexpr bool
    ends_with( const CharT* s ) const;
(3) (seit C++20)

Prüft, ob der String mit dem gegebenen Suffix endet. Das Suffix kann eines der folgenden sein:

1) Eine String-Ansicht sv (die das Ergebnis einer impliziten Konvertierung von einem anderen std::basic_string sein kann).
2) Ein einzelnes Zeichen ch.
3) Ein null-terminierter Zeichenstring s.

Alle drei Überladungen geben effektiv std::basic_string_view<CharT, Traits>(data(), size()).ends_with(x) zurück, wobei x der Parameter ist.

Inhalt

[bearbeiten] Parameter

sv - Ein String-View, der das Ergebnis einer impliziten Konvertierung aus einem anderen std::basic_string sein kann.
ch - Ein einzelnes Zeichen.
s - Ein null-terminierter Zeichenstring.

[bearbeiten] Rückgabewert

true, wenn der String mit dem bereitgestellten Suffix endet, andernfalls false.

[bearbeiten] Anmerkungen

Feature-Test-Makro Wert Std Feature
__cpp_lib_starts_ends_with 201711L (C++20) Prüfung von String-Präfixen und -Suffixen: starts_with() und ends_with()

[bearbeiten] Beispiel

#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)
    );
}

[bearbeiten] Siehe auch

prüft, ob der String mit dem gegebenen Präfix beginnt
(public member function) [edit]
prüft, ob die Zeichenansicht mit dem gegebenen Präfix beginnt
(public member function of std::basic_string_view<CharT,Traits>) [edit]
(C++20)
prüft, ob die Zeichenansicht mit dem gegebenen Suffix endet
(public member function of std::basic_string_view<CharT,Traits>) [edit]
(C++23)
prüft, ob der String die gegebene Teilzeichenkette oder das gegebene Zeichen enthält
(public member function) [edit]
(C++23)
prüft, ob die Zeichenansicht die gegebene Teilzeichenkette oder das gegebene Zeichen enthält
(public member function of std::basic_string_view<CharT,Traits>) [edit]
vergleicht zwei Strings
(public member function) [edit]
gibt eine Teilzeichenkette zurück
(public member function) [edit]