std::list<T,Allocator>::size (3) - Linux Man Pages

std::list<T,Allocator>::size: std::list<T,Allocator>::size

NAME

std::list<T,Allocator>::size - std::list<T,Allocator>::size

Synopsis


size_type size() const; (until C++11)
size_type size() const noexcept; (since C++11)


Returns the number of elements in the container, i.e. std::distance(begin(), end()).

Parameters


(none)

Return value


The number of elements in the container.

Complexity


Constant or linear. (until C++11)
Constant. (since C++11)

Example


The following code uses size to display the number of elements in a std::list:
// Run this code


  #include <list>
  #include <iostream>


  int main()
  {
      std::list<int> nums {1, 3, 5, 7};


      std::cout << "nums contains " << nums.size() << " elements.\n";
  }

Output:


  nums contains 4 elements.

See also


         checks whether the container is empty
empty (public member function)
         returns the maximum possible number of elements
max_size (public member function)
         changes the number of elements stored
resize (public member function)