std::list<T,Allocator>::size - cppreference.com (original) (raw)

| size_type size() const; | | (noexcept since C++11) (constexpr since C++26) | | ------------------------ | | ---------------------------------------------- |

Returns the number of elements in the container.

[edit] Return value

std::distance(begin(), end())

[edit] Complexity

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

[edit] Example

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

#include #include   int main() { std::list nums {1, 3, 5, 7};   std::cout << "nums contains " << nums.size() << " elements.\n"; }

Output:

nums contains 4 elements.

[edit] See also

| | checks whether the container is empty (public member function) [edit] | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | returns the maximum possible number of elements (public member function) [edit] | | | changes the number of elements stored (public member function) [edit] | | | returns the size of a container or array (function template) [edit] |