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

void reserve( size_type new_cap = 0 );

constexpr void reserve( size_type new_cap );

void reserve();

Paramètres

Valeur de retour

(aucun)

Exceptions

Lance std::length_error si new_cap est supérieur à max_size() .

Peut lever toutes les exceptions levées par std:: allocator_traits < Allocator > :: allocate ( ) , telles que std::bad_alloc .

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 ).

Complexité

Au plus linéaire dans la size() de la chaîne.

Exemple

#include <cassert>
#include <iostream>
#include <string>
int main()
{
    std::string s;
    std::cout << "1) Initialement : " << s.capacity() << '\n';
    const std::string::size_type new_cap{101u};
    s.reserve(new_cap);
    assert(s.capacity() >= new_cap);
    std::cout << "2) Après reserve(" << new_cap << ") : " << s.capacity() << '\n';
    // observation du facteur de croissance de la capacité
    auto cap{s.capacity()};
    for (int check{}; check != 4; ++check)
    {
        while (cap == s.capacity())
            s += '$';
        cap = s.capacity();
        std::cout << (3) + check << ") Capacité : " << cap << '\n';
    }
//  s.reserve(); // déprécié/supprimé en C++20/26, utiliser :
    s.shrink_to_fit();
    std::cout << "7) Après shrink_to_fit : " << s.capacity() << '\n';
}

1) Initialement : 15
2) Après reserve(101) : 101
3) Capacité : 202
4) Capacité : 404
5) Capacité : 808
6) Capacité : 1616
7) Après shrink_to_fit : 809

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