CKTIS / C++
std::string::find — první výskyt a npos
Najdi index znaku nebo podřetězce a porovnej jej s `std::string::npos`, než ho použiješ jako index nebo než text zkopíruješ či změníš.
Verze: ISO C++23; implementation support may vary
Syntaxe
// 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 je členská funkce const typu std::string z hlavičky <string>. Vrací nejnižší index výskytu počítaný od nuly, který je alespoň pos (výchozí hodnota 0). Hledaný vzor se musí celý vejít do textu. Prázdný vzor odpovídá na pozici pos, pokud pos <= s.size(); neprázdný vzor nelze najít, pokud pos >= s.size(). Hledání rozlišuje velká a malá písmena. Indexy počítají prvky char, nikoli kódové body Unicode.
Výsledek má typ std::string::size_type. Pokud se vzor nenajde, funkce nevyvolá výjimku: vrátí std::string::npos, nejvyšší hodnotu tohoto typu bez znaménka. Ověř i != std::string::npos, než index použiješ k přístupu k prvku nebo k výpočtu. if (i) je nepravdivé pro platný výskyt na indexu 0 a pravdivé pro npos. Výsledek je číslo, nikoli iterátor ani pohled; po změně textu už nemusí označovat stejný výskyt.
Pro jeden znak použij s.find('!'). Pro podřetězec předej std::string, std::string_view nebo platný řetězec ukončený nulovým znakem, jako v s.find("ab"). V s.find(ptr, pos, count) určuje count délku vzoru, nikoli hranici hledání; vzor může obsahovat \0. Předaný ukazatel nebo pohled musí po celou dobu volání odkazovat na platná data. Neplatný rozsah nevede k výsledku npos, ale k nedefinovanému chování.
Přetížení pro char a std::string jsou noexcept; přetížení s ukazatelem nejsou deklarována jako noexcept. Šablonové přetížení dostupné od C++17 přijímá typy implicitně převoditelné na std::string_view, ale nikoli na const char*; jeho noexcept závisí na převodu na pohled. Od C++20 jsou všechna přetížení constexpr. Pokud stačí odpověď ano/ne a není třeba zadat počáteční pozici, můžeš použít s.contains('!') z C++23, pokud jej knihovna podporuje.
Je-li s už objektem typu std::string, ověř s.find('!') != std::string::npos před vytvořením pracovní kopie nebo změnou textu. Hledání samo o sobě s nekopíruje ani nemění. Tato kontrola odmítne !, ale nenahrazuje ostatní pravidla validace.
Příklady
#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);
}Výsledek
rejected at 0 accepted: abc.
V `!abc` je `!` na indexu `0`, takže funkce skončí před vytvořením kopie. V `abc` se znak nenajde, a teprve pak funkce vytvoří kopii a připojí k ní tečku.
Související lekce
- C++ · Lekce 15 · Pokročilá · Verze: 3