Skip to content

Search topics & cppreference

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

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

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

Containers
  • C++11
  • C++17
  • C++20
1 min readView on cppreference
NotebookLM
size_type size() const;
(noexcept since C++11)
(constexpr since C++20)

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.

Example

The following code uses size to display the number of elements in a std::vector<int>:

snippet.cpp
#include <cassert>
#include <vector>
 
int main()
{
    std::vector<int> nums;
    assert(nums.size() == 0);
    nums = {1, 2, 3, 4};
    assert(nums.size() == 4);
}

See also

returns the number of elements that can be held in currently allocated storage
(public member function)
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)
(C++17)(C++20)
returns the size of a container or array
(function template)

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.