(C++17) | ||||
| Sequence | ||||
(C++11) | ||||
(C++26) | ||||
(C++26) | ||||
(C++11) | ||||
| Associative | ||||
| Unordered associative | ||||
(C++11) | ||||
(C++11) | ||||
(C++11) | ||||
(C++11) | ||||
| Adaptors | ||||
(C++23) | ||||
(C++23) | ||||
(C++23) | ||||
(C++23) | ||||
| Views | ||||
(C++20) | ||||
(C++23) | ||||
| Tables | ||||
| Iterator invalidation | ||||
| Member function table | ||||
| Non-member function table |
constexprvoid resize( size_type count); | (1) | (since C++26) |
constexprvoid resize( size_type count,const value_type& value); | (2) | (since C++26) |
Resizes the container to containcount elements:
Contents |
| count | - | new size of the container |
| value | - | the value to initialize the new elements with |
| Type requirements | ||
| -If the following condition is satisfied, the behavior is undefined: | ||
Linear in the difference between the current size andcount.
If an exception is thrown for any reason, these functions have no effect (strong exception safety guarantee).
#include <inplace_vector>#include <print> int main(){std::inplace_vector<int,6> v(6,9);std::println("Initially, v = {}", v); v.resize(2);std::println("After resize(2), v = {}", v); v.resize(4);std::println("After resize(4), v = {}", v); v.resize(6,-1);std::println("After resize(6, -1), v = {}", v); try{std::print("Trying resize(13): "); v.resize(13);// throws, because count > N; v is left unchanged}catch(conststd::bad_alloc& ex){std::println("ex.what(): {}", ex.what());}std::println("After exception, v = {}", v);}
Possible output:
Initially, v = [9, 9, 9, 9, 9, 9]After resize(2), v = [9, 9]After resize(4), v = [9, 9, 0, 0]After resize(6, -1), v = [9, 9, 0, 0, -1, -1]Trying resize(13): ex.what(): std::bad_allocAfter exception, v = [9, 9, 0, 0, -1, -1]
[static] | returns the maximum possible number of elements (public static member function)[edit] |
| returns the number of elements (public member function)[edit] | |
[static] | returns the number of elements that can be held in currently allocated storage (public static member function)[edit] |
| checks whether the container is empty (public member function)[edit] |
