Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/container/vector/size"

From cppreference.com
< cpp‎ | container‎ | vector
m (r2.7.3) (Robot: Adding fr, it, pl, pt, ru)
m (Add link to edit the included template)
Line 1: Line 1:
{{cpp/container/size|vector}}
+
{{page template|cpp/container/size|vector}}
  
 
[[fr:cpp/container/vector/size]]
 
[[fr:cpp/container/vector/size]]

Revision as of 08:02, 14 October 2012

 
 
 
 
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()).

Contents

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

#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) [edit]
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]
(C++17)(C++20)
returns the size of a container or array
(function template) [edit]