libstdc++
vector
Go to the documentation of this file.
1 // <vector> -*- C++ -*-
2 
3 // Copyright (C) 2001-2026 Free Software Foundation, Inc.
4 //
5 // This file is part of the GNU ISO C++ Library. This library is free
6 // software; you can redistribute it and/or modify it under the
7 // terms of the GNU General Public License as published by the
8 // Free Software Foundation; either version 3, or (at your option)
9 // any later version.
10 
11 // This library is distributed in the hope that it will be useful,
12 // but WITHOUT ANY WARRANTY; without even the implied warranty of
13 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 // GNU General Public License for more details.
15 
16 // Under Section 7 of GPL version 3, you are granted additional
17 // permissions described in the GCC Runtime Library Exception, version
18 // 3.1, as published by the Free Software Foundation.
19 
20 // You should have received a copy of the GNU General Public License and
21 // a copy of the GCC Runtime Library Exception along with this program;
22 // see the files COPYING3 and COPYING.RUNTIME respectively. If not, see
23 // <http://www.gnu.org/licenses/>.
24 
25 /*
26  *
27  * Copyright (c) 1994
28  * Hewlett-Packard Company
29  *
30  * Permission to use, copy, modify, distribute and sell this software
31  * and its documentation for any purpose is hereby granted without fee,
32  * provided that the above copyright notice appear in all copies and
33  * that both that copyright notice and this permission notice appear
34  * in supporting documentation. Hewlett-Packard Company makes no
35  * representations about the suitability of this software for any
36  * purpose. It is provided "as is" without express or implied warranty.
37  *
38  *
39  * Copyright (c) 1996
40  * Silicon Graphics Computer Systems, Inc.
41  *
42  * Permission to use, copy, modify, distribute and sell this software
43  * and its documentation for any purpose is hereby granted without fee,
44  * provided that the above copyright notice appear in all copies and
45  * that both that copyright notice and this permission notice appear
46  * in supporting documentation. Silicon Graphics makes no
47  * representations about the suitability of this software for any
48  * purpose. It is provided "as is" without express or implied warranty.
49  */
50 
51 /** @file include/vector
52  * This is a Standard C++ Library header.
53  */
54 
55 #ifndef _GLIBCXX_VECTOR
56 #define _GLIBCXX_VECTOR 1
57 
58 #ifdef _GLIBCXX_SYSHDR
59 #pragma GCC system_header
60 #endif
61 
62 #include <bits/requires_hosted.h> // container
63 
64 #include <bits/stl_algobase.h>
65 #include <bits/allocator.h>
66 #include <bits/stl_construct.h>
67 #include <bits/stl_uninitialized.h>
68 #include <bits/stl_vector.h>
69 #include <bits/stl_bvector.h>
70 #include <bits/range_access.h>
71 #include <bits/erase_if.h>
72 
73 #ifndef _GLIBCXX_EXPORT_TEMPLATE
74 # include <bits/vector.tcc>
75 #endif
76 
77 #ifdef _GLIBCXX_DEBUG
78 # include <debug/vector>
79 #endif
80 
81 #define __glibcxx_want_algorithm_default_value_type
82 #define __glibcxx_want_allocator_traits_is_always_equal
83 #define __glibcxx_want_constexpr_vector
84 #define __glibcxx_want_containers_ranges
85 #define __glibcxx_want_erase_if
86 #define __glibcxx_want_incomplete_container_elements
87 #define __glibcxx_want_nonmember_container_access
88 #include <bits/version.h>
89 
90 #if __cplusplus >= 201703L
91 #include <bits/memory_resource.h>
92 namespace std _GLIBCXX_VISIBILITY(default)
93 {
94 _GLIBCXX_BEGIN_NAMESPACE_VERSION
95  namespace pmr {
96  template<typename _Tp>
98  } // namespace pmr
99 # ifdef _GLIBCXX_DEBUG
100  namespace _GLIBCXX_STD_C::pmr {
101  template<typename _Tp>
102  using vector
103  = _GLIBCXX_STD_C::vector<_Tp, std::pmr::polymorphic_allocator<_Tp>>;
104  } // namespace _GLIBCXX_STD_C::pmr
105 # endif
106 _GLIBCXX_END_NAMESPACE_VERSION
107 } // namespace std
108 #endif // C++17
109 
110 #ifdef __cpp_lib_erase_if // C++ >= 20 && HOSTED
111 namespace std _GLIBCXX_VISIBILITY(default)
112 {
113 _GLIBCXX_BEGIN_NAMESPACE_VERSION
114 
115  template<typename _Tp, typename _Alloc, typename _Predicate>
116  constexpr typename _GLIBCXX_STD_C::vector<_Tp, _Alloc>::size_type
117  erase_if(_GLIBCXX_STD_C::vector<_Tp, _Alloc>& __cont, _Predicate __pred)
118  { return __detail::__erase_if(__cont, __cont, std::move(__pred)); }
119 
120  template<typename _Tp, typename _Alloc,
121  typename _Up _GLIBCXX26_DEF_VAL_T(_Tp)>
122  constexpr typename _GLIBCXX_STD_C::vector<_Tp, _Alloc>::size_type
123  erase(_GLIBCXX_STD_C::vector<_Tp, _Alloc>& __cont, const _Up& __value)
124  { return std::erase_if(__cont, __gnu_cxx::__ops::__equal_to(__value)); }
125 
126 _GLIBCXX_END_NAMESPACE_VERSION
127 } // namespace std
128 #endif // __cpp_lib_erase_if
129 
130 #ifdef __glibcxx_format_ranges // C++ >= 20 && HOSTED
131 #include <bits/formatfwd.h>
132 
133 namespace std _GLIBCXX_VISIBILITY(default)
134 {
135 _GLIBCXX_BEGIN_NAMESPACE_VERSION
136  // Standard does not constrain accepted _CharT and declares it as formatter
137  // of Tp that statisfies is-vector-bool-reference<T>,
138  template<__format::__char _CharT>
139  struct formatter<_GLIBCXX_STD_C::_Bit_reference, _CharT>
140  {
141  // Standard declares this as template accepting unconstrained
142  // ParseContext type.
143  constexpr typename basic_format_parse_context<_CharT>::iterator
144  parse(basic_format_parse_context<_CharT>& __pc)
145  { return _M_f.template _M_parse<bool>(__pc); }
146 
147  // Standard declares this as template accepting unconstrained
148  // FormatContext type.
149  template<typename _Out>
150  typename basic_format_context<_Out, _CharT>::iterator
151  format(const _GLIBCXX_STD_C::_Bit_reference& __u,
152  basic_format_context<_Out, _CharT>& __fc) const
153  { return _M_f.format(static_cast<bool>(__u), __fc); }
154 
155  private:
156  __format::__formatter_int<_CharT> _M_f;
157  };
158 
159 #if __glibcxx_print >= 202406L
160  template<>
161  inline constexpr bool
162  enable_nonlocking_formatter_optimization<_GLIBCXX_STD_C::_Bit_reference> = true;
163 #endif
164 
165 _GLIBCXX_END_NAMESPACE_VERSION
166 } // namespace std
167 #endif // __glibcxx_format_ranges
168 
169 #endif /* _GLIBCXX_VECTOR */
constexpr std::remove_reference< _Tp >::type && move(_Tp &&__t) noexcept
Convert a value to an rvalue.
Definition: move.h:138
ISO C++ entities toplevel namespace is std.
A standard container which offers fixed time access to individual elements in any order.
Definition: stl_vector.h:461