Namespaces
Variants
Views
Actions

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

From cppreference.com
< cpp‎ | container‎ | vector
m (Shorten template names. Use {{lc}} where appropriate.)
m (added link to cs translation)
Line 1: Line 1:
 
{{include page|cpp/container/size|vector}}
 
{{include page|cpp/container/size|vector}}
  
 +
[[cs:cpp/container/vector/size]]
 
[[de:cpp/container/vector/size]]
 
[[de:cpp/container/vector/size]]
 
[[es:cpp/container/vector/size]]
 
[[es:cpp/container/vector/size]]

Revision as of 11:25, 17 February 2014

 
 
 
 
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]