libstdc++
forward_list
Go to the documentation of this file.
1// <forward_list> -*- C++ -*-
2
3// Copyright (C) 2008-2025 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/** @file include/forward_list
26 * This is a Standard C++ Library header.
27 */
28
29#ifndef _GLIBCXX_FORWARD_LIST
30#define _GLIBCXX_FORWARD_LIST 1
31
32#ifdef _GLIBCXX_SYSHDR
33#pragma GCC system_header
34#endif
35
36#include <bits/requires_hosted.h> // containers
37
38#if __cplusplus < 201103L
39# include <bits/c++0x_warning.h>
40#else
41
42#include <bits/forward_list.h>
43#include <bits/range_access.h>
44#include <bits/forward_list.tcc>
45
46#ifdef _GLIBCXX_DEBUG
47# include <debug/forward_list>
48#endif
49
50#define __glibcxx_want_algorithm_default_value_type
51#define __glibcxx_want_allocator_traits_is_always_equal
52#define __glibcxx_want_containers_ranges
53#define __glibcxx_want_erase_if
54#define __glibcxx_want_incomplete_container_elements
55#define __glibcxx_want_list_remove_return_type
56#define __glibcxx_want_nonmember_container_access
57#include <bits/version.h>
58
59#if __cplusplus >= 201703L
60#include <bits/memory_resource.h>
61namespace std _GLIBCXX_VISIBILITY(default)
62{
63_GLIBCXX_BEGIN_NAMESPACE_VERSION
64 namespace pmr
65 {
66 template<typename _Tp>
67 using forward_list = std::forward_list<_Tp, polymorphic_allocator<_Tp>>;
68 } // namespace pmr
69_GLIBCXX_END_NAMESPACE_VERSION
70} // namespace std
71#endif // C++17
72
73#ifdef __cpp_lib_erase_if // C++ >= 20 && HOSTED
74namespace std _GLIBCXX_VISIBILITY(default)
75{
76_GLIBCXX_BEGIN_NAMESPACE_VERSION
77 template<typename _Tp, typename _Alloc, typename _Predicate>
78 inline typename forward_list<_Tp, _Alloc>::size_type
79 erase_if(forward_list<_Tp, _Alloc>& __cont, _Predicate __pred)
80 { return __cont.remove_if(__pred); }
81
82 template<typename _Tp, typename _Alloc,
83 typename _Up _GLIBCXX26_DEF_VAL_T(_Tp)>
84 inline typename forward_list<_Tp, _Alloc>::size_type
85 erase(forward_list<_Tp, _Alloc>& __cont, const _Up& __value)
86 {
87 // _GLIBCXX_RESOLVE_LIB_DEFECTS
88 // 4135. helper lambda of std::erase for list should specify return type
89 return std::erase_if(__cont, [&](const auto& __elem) -> bool {
90 return __elem == __value;
91 });
92 }
93_GLIBCXX_END_NAMESPACE_VERSION
94} // namespace std
95#endif // __cpp_lib_erase_if
96
97#endif // C++11
98
99#endif // _GLIBCXX_FORWARD_LIST