Namespaces
Variants

    std::erase, std::erase_if(std::basic_string)

    Depuis fr.cppreference.net

     
    C++
    Support du compilateur
    Autonome et hébergé
    Langage
    Bibliothèque standard
    En-têtes de la bibliothèque standard
    Exigences nommées
    Macros de test de fonctionnalités (C++20)
    Bibliothèque de support linguistique
    Bibliothèque de concepts (C++20)
    Bibliothèque de diagnostics
    Bibliothèque de gestion mémoire
    Bibliothèque de métaprogrammation (C++11)
    Bibliothèque d'utilitaires généraux
    Bibliothèque de conteneurs
    Bibliothèque d'itérateurs
    Bibliothèque de plages (C++20)
    Bibliothèque d'algorithmes
    Bibliothèque de chaînes
    Bibliothèque de traitement de texte
    Bibliothèque numérique
    Bibliothèque de date et heure
    Bibliothèque d'entrée/sortie
    Bibliothèque de système de fichiers (C++17)
    Bibliothèque de support de la concurrence (C++11)
    Bibliothèque de contrôle d'exécution (C++26)
    Spécifications techniques
    Index des symboles
    Bibliothèques externes
     
    Bibliothèque de chaînes
     
    std::basic_string
     
    Défini dans l'en-tête <string> 
    template< class CharT, class Traits, class Alloc, class U >
constexpr std::basic_string<CharT, Traits, Alloc>::size_type
    erase( std::basic_string<CharT, Traits, Alloc>& c, const U& value );
    		(1) (depuis C++20)
    (jusqu'à C++26)    		 
    template< class CharT, class Traits, class Alloc, class U = CharT >
constexpr std::basic_string<CharT, Traits, Alloc>::size_type
    erase( std::basic_string<CharT, Traits, Alloc>& c, const U& value );
    		(depuis C++26) 
    template< class CharT, class Traits, class Alloc, class Pred >
constexpr std::basic_string<CharT, Traits, Alloc>::size_type
    erase_if( std::basic_string<CharT, Traits, Alloc>& c, Pred pred );
    		(2) (depuis C++20)
    1) Efface tous les éléments qui sont égaux à value du conteneur. Équivalent à 
    auto it = std::remove(c.begin(), c.end(), value);
auto r = c.end() - it;
c.erase(it, c.end());
return r;
    2) Efface tous les éléments qui satisfont le prédicat pred du conteneur. Équivalent à 
    auto it = std::remove_if(c.begin(), c.end(), pred);
auto r = c.end() - it;
c.erase(it, c.end());
return r;

    Paramètres

    c - conteneur duquel effacer
    value - valeur à supprimer
    pred - prédicat unaire qui renvoie ​ true si l'élément doit être effacé.

    L'expression pred ( v ) doit être convertible en bool pour chaque argument v de type (éventuellement const) CharT , indépendamment de la catégorie de valeur , et ne doit pas modifier v . Ainsi, un type de paramètre CharT & n'est pas autorisé , pas plus que CharT sauf si pour CharT un déplacement équivaut à une copie (depuis C++11) . ​

    Valeur de retour

    Le nombre d'éléments effacés.

    Complexité

    Linéaire.

    Notes

    Macro de test de fonctionnalité Valeur Norme Fonctionnalité
    __cpp_lib_algorithm_default_value_type 202403 (C++26) Initialisation par liste pour std::erase

    Exemple

    Exécuter ce code
    #include <iomanip>
#include <iostream>
#include <string>

int main()
{
    std::string word{"startling"};
    std::cout << "Initially, word = " << std::quoted(word) << '\n';

    std::erase(word, 'l');
    std::cout << "After erase 'l': " << std::quoted(word) << '\n';

    auto erased = std::erase_if(word, [](char x)
    {
        return x == 'a' or x == 'r' or x == 't';
    });

    std::cout << "After erase all 'a', 'r', and 't': " << std::quoted(word) << '\n';
    std::cout << "Erased symbols count: " << erased << '\n';

#if __cpp_lib_algorithm_default_value_type
    std::erase(word, {'g'});
    std::cout << "After erase {'g'}: " << std::quoted(word) << '\n';
#endif
}

    Sortie possible : 

    Initially, word = "startling"
After erase 'l', word = "starting"
After erase all 'a', 'r', and 't': "sing"
Erased symbols count: 4
After erase {'g'}: "sin"

    Voir aussi

    		 supprime des caractères
    (fonction membre publique)
    		supprime les éléments satisfaisant des critères spécifiques
    (patron de fonction & objet fonction d'algorithme)
    (C++20)(C++20)
    (C++20)(C++20)
    		 supprime les éléments satisfaisant des critères spécifiques
    (objet fonction d'algorithme)