std::basic_string<CharT,Traits,Allocator>::find_first_not_of
size_type find_first_not_of( const basic_string& str,
size_type pos = 0 ) const;
|
(1) | (noexcept 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) | (noexcept 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(/* see below */);
|
(5) | (depuis C++17) (constexpr depuis C++20) |
Trouve le premier caractère qui n'est égal à aucun des caractères de la séquence de caractères donnée. La recherche ne considère que la plage [pos, size()). Si tous les caractères de la plage peuvent être trouvés dans la séquence de caractères donnée, npos sera retourné.
str.[s, s + count). Cette plage peut inclure des caractères nuls.[s, s + count) n'est pas une plage valide, le comportement est indéfini.s. La longueur de la chaîne est déterminée par le premier caractère nul en utilisant Traits::length(s).[s, s + Traits::length(s)) n'est pas une plage valide, le comportement est indéfini.ch.t en une vue chaîne sv comme si par std::basic_string_view<CharT, Traits> sv = t;, puis trouve le premier caractère qui n'est égal à aucun des caractères dans sv.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.
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
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>
)
|