Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::string::find — pierwsze dopasowanie i npos

Znajdź indeks znaku lub podciągu i porównaj wynik z `std::string::npos`, zanim użyjesz go jako indeksu albo skopiujesz lub zmienisz tekst.

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

Składnia

// 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 to metoda const klasy std::string z nagłówka <string>. Zwraca najmniejszy indeks dopasowania liczony od zera, nie mniejszy niż pos (domyślnie 0). Cały szukany ciąg musi mieścić się w tekście. Pusty ciąg pasuje na pozycji pos, jeśli pos <= s.size(); niepusty ciąg nie pasuje, jeśli pos >= s.size(). Porównanie rozróżnia wielkość liter, a indeks liczy elementy char, nie punkty kodowe Unicode.

Wynik ma typ std::string::size_type. Brak dopasowania nie wywołuje wyjątku: wynikiem jest std::string::npos, czyli największa wartość tego typu bez znaku. Sprawdź i != std::string::npos przed indeksowaniem lub działaniami na indeksie. if (i) daje wynik fałszywy dla poprawnego indeksu 0, a prawdziwy dla npos. Wynik jest liczbą, nie iteratorem ani widokiem, i po zmianie tekstu może już nie wskazywać tego samego dopasowania.

Użyj s.find('!') dla jednego znaku, a dla podciągu przekaż std::string, std::string_view lub poprawny napis zakończony znakiem zerowym, np. s.find("ab"). W s.find(ptr, pos, count) parametr count określa długość wzorca, nie granicę przeszukiwania; wzorzec może zawierać \0. Przekazany wskaźnik lub widok musi odwoływać się do poprawnych danych przez cały czas wywołania. Nieprawidłowy zakres nie oznacza npos: prowadzi do niezdefiniowanego zachowania.

Przeciążenia dla char i std::string są noexcept; przeciążenia wskaźnikowe nie są tak zadeklarowane. Szablon dostępny od C++17 przyjmuje typy niejawnie konwertowalne do std::string_view, ale nie do const char*; jego noexcept zależy od konwersji do widoku. Od C++20 wszystkie przeciążenia są constexpr. Gdy wystarczy odpowiedź tak/nie i nie potrzeba pozycji startowej, s.contains('!') to alternatywa z C++23, jeśli biblioteka ją obsługuje.

Jeśli s jest już obiektem std::string, sprawdź s.find('!') != std::string::npos przed utworzeniem kopii roboczej lub zmianą tekstu. Samo wyszukiwanie nie kopiuje ani nie zmienia s. To sprawdzenie odrzuca !, ale nie zastępuje pozostałych reguł walidacji.

Przykłady

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

Wynik

rejected at 0
accepted: abc.

W `!abc` znak `!` jest na pozycji `0`, więc funkcja kończy się przed wykonaniem kopii. Dla `abc` dopiero brak dopasowania pozwala utworzyć kopię i dopisać do niej kropkę.

Powiązane lekcje

  • C++ · Lekcja 15 · Zaawansowany · Wersja: 3

Źródła