Skip to content

Search topics & cppreference

Search all study topics, concept maps, and 6,587 C++ and C reference pages.

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

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

NotebookLM
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:

snippet.cpp
#include <iostream>
#include <list>
 
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
(public member function)
returns the maximum possible number of elements
(public member function)
changes the number of elements stored
(public member function)

Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.