CKTIS / C++
std::basic_string::find — ricerca di sottostringhe e separatori obbligatori
Trova la prima corrispondenza da una posizione iniziale, controlla `npos` e specifica la lunghezza del pattern se il buffer può contenere caratteri nulli interni.
Versione: ISO C++23; implementation support may vary
Sintassi
// ISO C++23; member declarations of std::basic_string<CharT, Traits, Allocator> in <string>
constexpr size_type find(const basic_string& str, size_type pos = 0) const noexcept;
constexpr size_type find(const CharT* s, size_type pos, size_type count) const;
constexpr size_type find(const CharT* s, size_type pos = 0) const;
constexpr size_type find(CharT ch, size_type pos = 0) const noexcept;
template<class T>
constexpr size_type find(const T& t, size_type pos = 0) const
noexcept(std::is_nothrow_convertible_v<const T&, std::basic_string_view<CharT, Traits>>);
// The template participates only if const T& is implicitly convertible to
// std::basic_string_view<CharT, Traits> but not to const CharT*.std::basic_string::find è una funzione membro const di <string>, disponibile anche su std::string. Restituisce un indice di tipo size_type a partire da zero: la prima posizione da pos in poi (0 per impostazione predefinita) in cui il pattern entra e corrisponde per intero. Confronta gli elementi tramite Traits::eq. Con UTF-8 memorizzato in std::string, l’indice conta i byte, non i caratteri visibili all’utente.
Se non trova corrispondenze, restituisce npos, il valore massimo di size_type, senza lanciare eccezioni. Un pattern vuoto corrisponde a pos se e solo se pos <= size(); un pattern non vuoto non può corrispondere se pos >= size(). Se il separatore è obbligatorio, controlla npos prima di indicizzare, estrarre una sottostringa o calcolare uno scostamento. L’indice 0 è un risultato valido.
find(ch, pos) cerca un singolo elemento CharT; find(str, pos) usa l’intera lunghezza di un basic_string. find(p, pos) richiede una sequenza terminata da un carattere nullo: Traits::length si ferma al primo. find(p, pos, count) usa esattamente count elementi del pattern, inclusi quelli nulli interni. Il secondo argomento è la posizione iniziale, non una lunghezza; count non limita la stringa in cui si cerca. Un intervallo di puntatori non valido causa comportamento indefinito: controlla che count non superi il numero di elementi leggibili a partire da p.
Da C++17, l’overload con template accetta const T& se è convertibile implicitamente in std::basic_string_view<CharT, Traits> ma non in const CharT*. Una vista conserva la propria lunghezza ma non possiede i dati. I dati a cui si riferisce una vista o un puntatore devono rimanere validi per tutta la chiamata. Per un buffer std::vector<char>, usa data() insieme a size(); non dare per scontato un carattere nullo finale.
Tutti gli overload sono constexpr da C++20. In C++23, quelli per basic_string e CharT sono noexcept, quelli con puntatore non sono dichiarati noexcept e quello con template è noexcept solo se la conversione alla vista non può lanciare eccezioni. Il supporto può variare in base all’implementazione.
Esempi
#include <iostream>
#include <string>
#include <string_view>
#include <vector>
int main() {
const std::string record{"A:B:\0=C", 7};
const std::vector<char> separator{':', '\0', '='};
std::cout << "C string: " << record.find(separator.data()) << '\n';
const auto split = record.find(separator.data(), 0, separator.size());
if (split == std::string::npos) {
std::cout << "Missing required separator\n";
return 1;
}
std::cout << "Counted separator: " << split << '\n';
const std::string_view marker{separator.data(), separator.size()};
const auto start = split + 1;
const auto next = record.find(marker, start);
std::cout << "From index " << start << ": ";
if (next == std::string::npos) {
std::cout << "not found\n";
} else {
std::cout << next << '\n';
}
}Risultato
C string: 1 Counted separator: 3 From index 4: not found
La chiamata con il solo puntatore cerca `:` e restituisce `1`. La chiamata con lunghezza trova il separatore obbligatorio completo `:\0=` all’indice `3`. La ricerca dello stesso pattern come vista a partire dall’indice `4` restituisce `npos`.
Lezioni correlate
- C++ · Lezione 58 · Avanzato · Versione: 3
Fonti
- Draft C++ Standard — basic_string searching [string.find]
- Draft C++ Standard — basic_string_view searching [string.view.find]
- Draft C++ Standard — basic_string_view construction and assignment [string.view.cons]
- Draft C++ Standard — Class template basic_string [basic.string]
- Draft C++ Standard — vector data [vector.data]
- WG21 N4950 — Working Draft, Standard for Programming Language C++