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

void reserve( size_type new_cap = 0 );

constexpr void reserve( size_type new_cap );

void reserve();

Parámetros

Valor de retorno

(ninguno)

Excepciones

Lanza std::length_error si new_cap es mayor que max_size() .

Puede lanzar cualquier excepción lanzada por std:: allocator_traits < Allocator > :: allocate ( ) , como std::bad_alloc .

Si se lanza una excepción por cualquier razón, esta función no tiene efecto ( strong exception safety guarantee ).

Complejidad

Como máximo lineal en el size() de la cadena.

Ejemplo

#include <cassert>
#include <iostream>
#include <string>
int main()
{
    std::string s;
    std::cout << "1) Inicialmente: " << s.capacity() << '\n';
    const std::string::size_type new_cap{101u};
    s.reserve(new_cap);
    assert(s.capacity() >= new_cap);
    std::cout << "2) Después de reserve(" << new_cap << "): " << s.capacity() << '\n';
    // observando el factor de crecimiento de la capacidad
    auto cap{s.capacity()};
    for (int check{}; check != 4; ++check)
    {
        while (cap == s.capacity())
            s += '$';
        cap = s.capacity();
        std::cout << (3) + check << ") Capacidad: " << cap << '\n';
    }
//  s.reserve(); // obsoleto/eliminado en C++20/26, usar:
    s.shrink_to_fit();
    std::cout << "7) Después de shrink_to_fit: " << s.capacity() << '\n';
}

1) Inicialmente: 15
2) Después de reserve(101): 101
3) Capacidad: 202
4) Capacidad: 404
5) Capacidad: 808
6) Capacidad: 1616
7) Después de shrink_to_fit: 809

Informes de defectos

Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares de C++ publicados anteriormente.

Véase también