std::basic_string<CharT,Traits,Allocator>:: find

Trouve la première sous-chaîne égale à la séquence de caractères donnée. La recherche commence à pos , c'est-à-dire que la sous-chaîne trouvée ne doit pas commencer à une position précédant pos .

Formellement, une sous-chaîne str est dite trouvée à la position xpos si toutes les conditions suivantes sont true :

• xpos >= pos
• xpos + str. size ( ) <= size ( )
• pour toutes les positions n dans str , Traits :: eq ( at ( xpos + n ) , str. at ( n ) ) .

En particulier, cela implique que

• une sous-chaîne peut être trouvée uniquement si pos <= size ( ) - str. size ( )
• une sous-chaîne vide est trouvée à pos si et seulement si pos <= size ( )
• pour une sous-chaîne non vide, si pos >= size ( ) , la fonction retourne toujours npos .

Paramètres

Valeur de retour

Position du premier caractère de la sous-chaîne trouvée ou npos si aucune sous-chaîne de ce type n'est trouvée.

Exceptions

Si une exception est levée pour quelque raison que ce soit, cette fonction n'a aucun effet ( strong exception safety guarantee ).

Exemple

#include <iomanip>
#include <iostream>
#include <string>
void print(int id, std::string::size_type n, std::string const& s)
{
    std::cout << id << ") ";
    if (std::string::npos == n)
        std::cout << "not found! n == npos\n";
    else
        std::cout << "found @ n = " << n << ", substr(" << n << ") = "
                  << std::quoted(s.substr(n)) << '\n';
}
int main()
{
    std::string::size_type n;
    std::string const s = "This is a string"; /*
                             ^  ^  ^
                             1  2  3          */
    // recherche depuis le début de la chaîne
    n = s.find("is");
    print(1, n, s);
    // recherche à partir de la position 5
    n = s.find("is", 5);
    print(2, n, s);
    // recherche d'un caractère unique
    n = s.find('a');
    print(3, n, s);
    // recherche d'un caractère unique
    n = s.find('q');
    print(4, n, s);
}

1) found @ n = 2, substr(2) = "is is a string"
2) found @ n = 5, substr(5) = "is a string"
3) found @ n = 8, substr(8) = "a string"
4) not found! n == npos

Rapports de défauts

Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.

Voir aussi