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

From cppreference.com
< cpp‎ | container‎ | list
C++
Containers library
std::list
Member functions
Non-member functions
(until C++20) (until C++20) (until C++20) (until C++20) (until C++20)
Deduction guides(C++17)
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 <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)
Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/container/list/size&oldid=161906