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