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

size_type find_first_not_of( const basic_string& str,
                             size_type pos = 0 ) const;

size_type find_first_not_of( const CharT* s,
                             size_type pos, size_type count ) const;

size_type find_first_not_of( const CharT* s,
                             size_type pos = 0 ) const;

size_type find_first_not_of( CharT ch, size_type pos = 0 ) const;

template< class StringViewLike >
size_type
    find_first_not_of( const StringViewLike& t,
                       size_type pos = 0 ) const noexcept(/* see below */);

Findet das erste Zeichen, das keinem der Zeichen in der angegebenen Zeichensequenz entspricht. Die Suche berücksichtigt nur den Bereich [pos, size()). Wenn alle Zeichen in diesem Bereich in der angegebenen Zeichensequenz gefunden werden können, wird npos zurückgegeben.

In allen Fällen wird die Gleichheit durch Aufruf von Traits::eq überprüft.

Parameter

Rückgabewert

Position des gefundenen Zeichens oder std::string::npos falls kein solches Zeichen gefunden wurde.

Ausnahmen

Wenn aus irgendeinem Grund eine Exception ausgelöst wird, hat diese Funktion keine Wirkung ( strong exception safety guarantee ).

Beispiel

#include <iostream>
#include <string>
int main()
{
    // Großbuchstaben, Kleinbuchstaben und Zahlen in Makronamen erlauben
    const char* pattern = "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
                          "abcdefghijklmnopqrstuvwxyz"
                          "0123456789";
    std::string data = "1) %FIX, 2) %HACK, and 3) %TODO";
    const std::string replacement = "%DONE%";
    std::cout << "Before: " << data << '\n';
    for (std::string::size_type first{}, last{};
        (first = data.find('%', first)) != std::string::npos;
        first += replacement.size())
    {
        last = data.find_first_not_of(pattern, first + 1);
        if (last == std::string::npos)
            last = data.length();
        // Jetzt ist first bei '%' und last ist eine Position nach dem Ende des gefundenen Teilstrings
        data.replace(first, last - first, replacement);
    }
    std::cout << "After: " << data << '\n';
}

Before: 1) %FIX, 2) %HACK, and 3) %TODO
After: 1) %DONE%, 2) %DONE%, and 3) %DONE%

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

Siehe auch