std::list::resize

Parameters

n

New container size, expressed in number of elements.
Member type size_type is an unsigned integral type.

val

Object whose content is copied to the added elements in case that n is greater than the current container size.
If not specified, the default constructor is used instead.
Member type value_type is the type of the elements in the container, defined in list as an alias of the first template parameter (T).

Return Value

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

// resizing list
#include <iostream>
#include <list>
int main ()
{
  std::list<int> mylist;
  // set some initial content:
  for (int i=1; i<10; ++i) mylist.push_back(i);
  mylist.resize(5);
  mylist.resize(8,100);
  mylist.resize(12);
  std::cout << "mylist contains:";
  for (std::list<int>::iterator it=mylist.begin(); it!=mylist.end(); ++it)
    std::cout << ' ' << *it;
  std::cout << '\n';
  return 0;
}

mylist contains: 1 2 3 4 5 100 100 100 0 0 0 0

Complexity

Iterator validity

Data races

Exception safety

See also

list::size

Return size (public member function)

list::clear

Clear content (public member function)

list::erase

Erase elements (public member function)

list::max_size

Return maximum size (public member function)