Namespaces
Variants

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

From cppreference.net
std::basic_string
size_type find_first_not_of ( const basic_string & str,
size_type pos = 0 ) const ;
(1) (aucune exception depuis C++11)
(constexpr depuis C++20)
size_type find_first_not_of ( const CharT * s,
size_type pos, size_type count ) const ;
(2) (constexpr depuis C++20)
size_type find_first_not_of ( const CharT * s,
size_type pos = 0 ) const ;
(3) (constexpr depuis C++20)
size_type find_first_not_of ( CharT ch, size_type pos = 0 ) const ;
(4) (aucune exception depuis C++11)
(constexpr depuis C++20)
template < class StringViewLike >

size_type
find_first_not_of ( const StringViewLike & t,

size_type pos = 0 ) const noexcept ( /* voir ci-dessous */ ) ;
(5) (depuis C++17)
(constexpr depuis C++20)

Trouve le premier caractère différent de tous les caractères dans la séquence de caractères donnée. La recherche ne considère que l'intervalle [ pos , size() ) . Si tous les caractères de l'intervalle sont présents dans la séquence de caractères donnée, npos sera retourné.

1) Trouve le premier caractère différent de tous les caractères dans str .
2) Trouve le premier caractère différent de tous les caractères dans l'intervalle [ s , s + count ) . Cet intervalle peut inclure des caractères nuls.
Si [ s , s + count ) n'est pas un intervalle valide , le comportement est indéfini.
3) Trouve le premier caractère différent de tous les caractères dans la chaîne pointée par s . La longueur de la chaîne est déterminée par le premier caractère nul en utilisant Traits::length(s) .
Si [ s , s + Traits :: length ( s ) ) n'est pas un intervalle valide , le comportement est indéfini.
4) Trouve le premier caractère différent de ch .
5) Convertit implicitement t en une vue de chaîne sv comme si par std:: basic_string_view < CharT, Traits > sv = t ; , puis trouve le premier caractère différent de tous les caractères dans sv .
Cette surcharge participe à la résolution de surcharge seulement si std:: is_convertible_v < const StringViewLike & ,
std:: basic_string_view < CharT, Traits >>
est true et std:: is_convertible_v < const StringViewLike & , const CharT * > est false .

Dans tous les cas, l'égalité est vérifiée en appelant Traits::eq .

Table des matières

Paramètres

str - chaîne identifiant les caractères à rechercher
pos - position de départ de la recherche
count - longueur de la chaîne de caractères identifiant les caractères à rechercher
s - pointeur vers une chaîne de caractères identifiant les caractères à rechercher
ch - caractère identifiant les caractères à rechercher
t - objet (convertible en std::basic_string_view ) identifiant les caractères à rechercher

Valeur de retour

Position du caractère trouvé ou std::string::npos si aucun caractère n'est trouvé.

Exceptions

1,4) Ne lance rien.
5)
noexcept spécification :
noexcept ( std:: is_nothrow_convertible_v < const T & , std:: basic_string_view < CharT, Traits >> )

Si une exception est levée pour quelque raison que ce soit, cette fonction n'a aucun effet ( garantie forte de sûreté face aux exceptions ).

Exemple

#include <iostream>
#include <string>
int main()
{
    // Autoriser les lettres majuscules, minuscules et chiffres dans les noms de macro
    const char* pattern = "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
                          "abcdefghijklmnopqrstuvwxyz"
                          "0123456789";
    std::string data = "1) %FIX, 2) %HACK, and 3) %TODO";
    const std::string replacement = "%DONE%";
    std::cout << "Before: " << data << '\n';
    for (std::string::size_type first{}, last{};
        (first = data.find('%', first)) != std::string::npos;
        first += replacement.size())
    {
        last = data.find_first_not_of(pattern, first + 1);
        if (last == std::string::npos)
            last = data.length();
        // Maintenant first au '%' et last est un après la fin de la sous-chaîne trouvée
        data.replace(first, last - first, replacement);
    }
    std::cout << "After: " << data << '\n';
}

Sortie :

Before: 1) %FIX, 2) %HACK, and 3) %TODO
After: 1) %DONE%, 2) %DONE%, and 3) %DONE%

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.

DR Appliqué à Comportement publié Comportement corrigé
LWG 847 C++98 il n'y avait aucune garantie de sécurité des exceptions garantie de sécurité forte des exceptions ajoutée
LWG 2064 C++11 les surcharges (3,4) étaient noexcept supprimé
LWG 2946 C++17 la surcharge (5) causait une ambiguïté dans certains cas évité en la rendant template
P1148R0 C++11
C++17
noexcept pour les surcharges (4,5) a été
accidentellement supprimé par LWG2064/LWG2946
restauré

Voir aussi

trouve la première occurrence de la sous-chaîne donnée
(fonction membre publique)
trouve la dernière occurrence d'une sous-chaîne
(fonction membre publique)
trouve la première occurrence de caractères
(fonction membre publique)
trouve la dernière occurrence de caractères
(fonction membre publique)
trouve la dernière absence de caractères
(fonction membre publique)
trouve la première absence de caractères
(fonction membre publique de std::basic_string_view<CharT,Traits> )