WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::string::find — erster Treffer und npos

Ermittle den Index eines Zeichens oder Teilstrings und vergleiche ihn mit `std::string::npos`, bevor du ihn als Index nutzt oder den Text kopierst oder änderst.

Version: ISO C++23; implementation support may vary

Syntax

// C++23 member declarations, with types written for std::string (<string>).
// The template participates only if const T& is implicitly convertible to
// std::string_view but not to const char*.
constexpr size_type find(char ch, size_type pos = 0) const noexcept;
constexpr size_type find(const std::string& needle, size_type pos = 0) const noexcept;
constexpr size_type find(const char* needle, size_type pos = 0) const;
constexpr size_type find(const char* needle, size_type pos, size_type count) const;
template<class T>
constexpr size_type find(const T& needle, size_type pos = 0) const
    noexcept(std::is_nothrow_convertible_v<const T&, std::string_view>);
static constexpr size_type npos = size_type(-1);

std::string::find ist eine const-Memberfunktion von std::string aus <string>. Sie liefert den kleinsten nullbasierten Trefferindex ab pos (Standardwert 0). Das gesamte Suchmuster muss in den Text passen. Ein leeres Muster passt an Position pos, wenn pos <= s.size() gilt; ein nicht leeres Muster kann bei pos >= s.size() nicht passen. Die Suche unterscheidet Groß- und Kleinschreibung. Indizes zählen char-Elemente, keine Unicode-Codepunkte.

Das Ergebnis hat den Typ std::string::size_type. Bleibt die Suche erfolglos, wird keine Ausnahme ausgelöst: Das Ergebnis ist std::string::npos, der größte Wert dieses vorzeichenlosen Typs. Prüfe i != std::string::npos, bevor du indizierst oder mit dem Index rechnest. if (i) ist für einen Treffer bei 0 falsch und für npos wahr. Das Ergebnis ist eine Zahl, kein Iterator und keine View; nach einer Textänderung kann es aufhören, denselben Treffer zu bezeichnen.

Verwende s.find('!') für ein einzelnes Zeichen. Für einen Teilstring übergibst du einen std::string, eine std::string_view oder eine gültige nullterminierte Zeichenfolge, etwa in s.find("ab"). Bei s.find(ptr, pos, count) ist count die Musterlänge, keine Suchgrenze; das Muster darf \0 enthalten. Übergebene Zeiger und Views müssen während des gesamten Aufrufs auf gültige Daten verweisen. Ein ungültiger Bereich ergibt nicht npos, sondern führt zu undefiniertem Verhalten.

Die Überladungen für char und std::string sind noexcept; die Zeigerüberladungen sind nicht als noexcept deklariert. Die Template-Überladung seit C++17 akzeptiert Typen, die implizit in std::string_view, aber nicht in const char* konvertierbar sind. Ihr noexcept hängt von der Konvertierung in die View ab. Seit C++20 sind alle Überladungen constexpr. Wenn nur Ja oder Nein und keine Startposition nötig ist, ist s.contains('!') eine C++23-Alternative, sofern die Bibliothek sie unterstützt.

Ist s bereits ein std::string, prüfe s.find('!') != std::string::npos, bevor du eine Arbeitskopie erstellst oder den Text änderst. Die Suche selbst kopiert oder verändert s nicht. Die Prüfung weist ! zurück, ersetzt aber keine anderen Validierungsregeln.

Beispiele

#include <iostream>
#include <string>

void process(const std::string& input) {
    const auto bad = input.find('!');
    if (bad != std::string::npos) {
        std::cout << "rejected at " << bad << '\n';
        return;
    }

    auto result = input;
    result += '.';
    std::cout << "accepted: " << result << '\n';
}

int main() {
    const std::string invalid = "!abc";
    const std::string valid = "abc";
    process(invalid);
    process(valid);
}

Ergebnis

rejected at 0
accepted: abc.

In `!abc` steht `!` an Index `0`, daher kehrt die Funktion vor dem Kopieren zurück. Bei `abc` gibt es keinen Treffer; erst dann erstellt die Funktion eine Kopie und hängt einen Punkt an.

Zugehörige Lektionen

  • C++ · Lektion 15 · Fortgeschritten · Version: 3

Quellen