Namespaces
Variants
Views
Actions

Difference between revisions of "Template:cpp/container/size"

From cppreference.com
m (Update links.)
m (+inplace_vector.)
 
(17 intermediate revisions by 8 users not shown)
Line 1: Line 1:
−
{{cpp/container/{{{1|}}}/title | size}}
+
{{#vardefine:cont|{{{1|inplace_vector}}}}}<!--
−
{{cpp/container/{{{1|}}}/navbar}}
+
-->{{cpp/container/{{#var:cont}}/title|size}}
−
{{ddcl | notes={{cpp/container/mark since c++11 | {{{1|}}} }} |
+
{{cpp/container/{{#var:cont}}/navbar}}
−
{{#ifeq:{{{1|}}}|array|constexpr size_type size() const; | size_type size() const;}}
+
{{dcl begin}}
 +
{{#switch:{{#var:cont}}
 +
|array=
 +
{{dcl|since=c++11|
 +
constexpr size_type size() const noexcept;
 
}}
 
}}
 +
|vector=
 +
{{dcl|notes={{mark noexcept since c++11}}<br>{{mark constexpr since c++20}}|
 +
size_type size() const;
 +
}}
 +
|inplace_vector=
 +
{{dcl|since=c++26|
 +
constexpr size_type size() const;
 +
}}
 +
|
 +
{{cpp/container/noexcept dcl|{{#var:cont}}|dcl=
 +
size_type size() const
 +
}}
 +
}}
 +
{{dcl end}}
  
 
Returns the number of elements in the container, i.e. {{c|std::distance(begin(), end())}}.
 
Returns the number of elements in the container, i.e. {{c|std::distance(begin(), end())}}.
Line 11: Line 29:
  
 
===Return value===
 
===Return value===
−
The number of elements in the container
+
The number of elements in the container.
−
 
+
−
===Exceptions===
+
−
{{noexcept}}
+
  
 
===Complexity===
 
===Complexity===
−
{{#ifeq: {{{1|}}}|list|
+
Constant.
−
{{rev list begin}}
+
−
{{rev list item | Constant or linear | {{mark until c++11}} }}
+
−
{{rev list item | Constant | {{mark since c++11}}}}
+
−
{{rev list end}}
+
−
| Constant.
+
−
}}
+
  
 
===Example===
 
===Example===
−
{{include | cpp/container/{{{1|}}}/example_size}}
+
{{#switch:{{#var:cont}}
 +
|set|multiset|unordered_set|unordered_multiset
 +
={{include|cpp/container/set/example size|{{#var:cont}}}}
 +
|map|multimap|unordered_map|unordered_multimap
 +
={{include|cpp/container/map/example size|{{#var:cont}}}}
 +
|{{include|cpp/container/{{#var:cont}}/example size}}
 +
}}
  
 
===See also===
 
===See also===
 
{{dsc begin}}
 
{{dsc begin}}
−
{{#ifeq: {{{1|}}} | vector | {{dsc inc | cpp/container/dsc capacity |{{{1|}}}}} }}
+
{{#switch:{{#var:cont}}|vector|inplace_vector={{dsc inc|cpp/container/dsc capacity|{{#var:cont}}}}}}
−
{{dsc inc | cpp/container/dsc empty |{{{1|}}}}}
+
{{dsc inc|cpp/container/dsc empty|{{#var:cont}}}}
−
{{dsc inc | cpp/container/dsc max_size |{{{1|}}}}}
+
{{dsc inc|cpp/container/dsc max_size|{{#var:cont}}}}
−
{{#switch:{{{1|}}} | vector | deque | list | forward_list={{dsc inc | cpp/container/dsc resize |{{{1|}}}}} }}
+
{{#switch:{{#var:cont}}|vector|inplace_vector|deque|list|forward_list={{dsc inc|cpp/container/dsc resize|{{#var:cont}}}}}}
 +
{{dsc inc|cpp/iterator/dsc size}}
 
{{dsc end}}
 
{{dsc end}}

Latest revision as of 22:44, 9 August 2024

 
C++
 
Containers library
 
std::inplace_vector
Member types
Member functions
Non-member functions
 
constexpr size_type size() const;
 (since C++26)

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

Contents

[edit] Parameters

(none)

[edit] Return value

The number of elements in the container.

[edit] Complexity

Constant.

[edit] Example

[edit]
Run this code
#include <cassert>
#include <inplace_vector>
 
int main()
{
    std::inplace_vector<int, 4> nums;
    assert(nums.size() == 0);
    nums = {1, 2, 3, 4};
    assert(nums.size() == 4);
}

[edit] See also

[static]
 returns the number of elements that can be held in currently allocated storage
(public static member function of std::inplace_vector<T,N>) [edit]
checks whether the container is empty
(public member function of std::inplace_vector<T,N>) [edit]
[static]
 returns the maximum possible number of elements
(public static member function of std::inplace_vector<T,N>) [edit]
changes the number of elements stored
(public member function of std::inplace_vector<T,N>) [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=174181"