Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::basic_string::find — rechercher une sous-chaîne ou un séparateur obligatoire

Trouvez la première occurrence à partir d’une position donnée, testez `npos` et indiquez la longueur du motif si un tampon peut contenir des caractères nuls internes.

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

Syntaxe

// 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 est une fonction membre const de <string>, également disponible sur std::string. Elle renvoie un indice de type size_type, compté à partir de zéro : la première position à partir de pos (0 par défaut) où le motif tient et correspond en entier. La comparaison utilise Traits::eq. Pour de l’UTF-8 stocké dans un std::string, l’indice compte des octets, pas des caractères visibles par l’utilisateur.

En l’absence de correspondance, la fonction renvoie npos, la plus grande valeur de size_type, sans lever d’exception. Un motif vide correspond à la position pos si et seulement si pos <= size() ; un motif non vide ne peut pas correspondre si pos >= size(). Pour un séparateur obligatoire, testez npos avant d’indexer, d’extraire une sous-chaîne ou de calculer un décalage. L’indice 0 est un résultat valide.

find(ch, pos) cherche un seul élément CharT ; find(str, pos) utilise toute la longueur d’un basic_string. find(p, pos) exige une séquence terminée par un caractère nul : Traits::length s’arrête au premier. find(p, pos, count) utilise exactement count éléments du motif, y compris les caractères nuls internes. Le deuxième argument est la position de départ, pas une longueur ; count ne borne pas la chaîne parcourue. Une plage de pointeurs invalide entraîne un comportement indéfini : vérifiez que count ne dépasse pas le nombre d’éléments lisibles à partir de p.

Depuis C++17, la surcharge générique accepte const T& si ce type est implicitement convertible en std::basic_string_view<CharT, Traits>, mais pas en const CharT*. Une vue conserve sa longueur sans posséder les données. Les données référencées par une vue ou un pointeur doivent rester valides pendant tout l’appel. Pour un tampon std::vector<char>, associez data() à size() ; ne supposez pas la présence d’un caractère nul final.

Toutes les surcharges sont constexpr depuis C++20. En C++23, les surcharges pour basic_string et CharT sont noexcept, celles à pointeur ne sont pas déclarées noexcept, et la surcharge générique est noexcept uniquement si la conversion en vue ne peut pas lever d’exception. La prise en charge peut varier selon l’implémentation.

Exemples

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

Résultat

C string: 1
Counted separator: 3
From index 4: not found

L’appel avec le seul pointeur cherche `:` et renvoie `1`. L’appel avec longueur trouve le séparateur obligatoire complet `:\0=` à l’indice `3`. La recherche du même motif sous forme de vue à partir de l’indice `4` renvoie `npos`.

Leçons associées

  • C++ · Leçon 58 · Avancé · Version : 3

Sources