Namespaces
Variants
Views
Actions

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

From cppreference.com
 
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;
 (noexcept since C++11)
(constexpr since C++26)

Returns the number of elements in the container.

Contents

[edit] Return value

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

[edit] Complexity

Constant or linear.

(until C++11)

Constant.

(since C++11)

[edit] Example

[edit]

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.

[edit] See also

 checks whether the container is empty
(public member function of std::list<T,Allocator>) [edit]
returns the maximum possible number of elements
(public member function of std::list<T,Allocator>) [edit]
changes the number of elements stored
(public member function of std::list<T,Allocator>) [edit]
(C++17)(C++20)
 returns the size of a container or array
(function template) [edit]
Retrieved from "https://en.cppreference.com/mwiki/index.php?title=Template:cpp/container/size&oldid=183105"