CKTIS / C++
std::string::find — première occurrence et npos
Trouvez l’indice d’un caractère ou d’une sous-chaîne, puis comparez-le à `std::string::npos` avant de l’utiliser comme indice ou de copier ou modifier le texte.
Version : 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 est une fonction membre const de std::string, définie dans <string>. Elle renvoie le plus petit indice, à partir de zéro, d’une occurrence qui commence à pos (par défaut 0) ou après. Le motif doit tenir entièrement dans le texte. Un motif vide correspond à pos si pos <= s.size() ; un motif non vide ne peut pas correspondre si pos >= s.size(). La recherche est sensible à la casse et les indices comptent les éléments char, pas les points de code Unicode.
Le résultat est de type std::string::size_type. L’absence d’occurrence ne lève pas d’exception : la fonction renvoie std::string::npos, la plus grande valeur de ce type non signé. Vérifiez i != std::string::npos avant d’utiliser l’indice ou de faire un calcul dessus. if (i) est faux pour une occurrence valide à 0 et vrai pour npos. Le résultat est un nombre, ni un itérateur ni une vue, et peut ne plus désigner la même occurrence après une modification du texte.
Utilisez s.find('!') pour un caractère. Pour une sous-chaîne, passez un std::string, un std::string_view ou une chaîne valide terminée par un caractère nul, comme dans s.find("ab"). Dans s.find(ptr, pos, count), count donne la longueur du motif, pas une limite de recherche ; le motif peut contenir \0. Tout pointeur ou toute vue passé en argument doit référencer des données valides pendant tout l’appel. Une plage invalide ne donne pas npos : elle entraîne un comportement indéfini.
Les surcharges pour char et std::string sont noexcept ; celles qui prennent un pointeur ne sont pas déclarées noexcept. La surcharge générique, disponible depuis C++17, accepte les types implicitement convertibles en std::string_view, mais pas en const char* ; son noexcept dépend de la conversion en vue. Toutes les surcharges sont constexpr depuis C++20. Pour un simple oui ou non, sans position de départ, s.contains('!') est une solution C++23 si la bibliothèque la prend en charge.
Lorsque s est déjà un std::string, testez s.find('!') != std::string::npos avant de créer une copie de travail ou de modifier le texte. La recherche elle-même ne copie ni ne modifie s. Ce test rejette !, sans remplacer les autres règles de validation.
Exemples
#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);
}Résultat
rejected at 0 accepted: abc.
Dans `!abc`, `!` est à l’indice `0` : la fonction se termine avant toute copie. Pour `abc`, elle ne trouve pas `!` et crée alors une copie à laquelle elle ajoute un point.
Leçons associées
- C++ · Leçon 15 · Avancé · Version : 3