1 // std::rel_ops implementation -*- C++ -*-
3 // Copyright (C) 2001-2024 Free Software Foundation, Inc.
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)
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.
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, 2009 Free Software Foundation.
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/>.
28 * Hewlett-Packard Company
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.
38 * Copyright (c) 1996,1997
41 * Permission to use, copy, modify, distribute and sell this software
42 * and its documentation for any purpose is hereby granted without fee,
43 * provided that the above copyright notice appear in all copies and
44 * that both that copyright notice and this permission notice appear
45 * in supporting documentation. Silicon Graphics makes no
46 * representations about the suitability of this software for any
47 * purpose. It is provided "as is" without express or implied warranty.
51 /** @file bits/stl_relops.h
52 * This is an internal header file, included by other library headers.
53 * Do not attempt to use it directly. @headername{utility}
55 * This file is only included by `<utility>`, which is required by the
56 * standard to define namespace `rel_ops` and its contents.
60 #define _STL_RELOPS_H 1
62 namespace std
_GLIBCXX_VISIBILITY(default)
64 _GLIBCXX_BEGIN_NAMESPACE_VERSION
68 /** @namespace std::rel_ops
69 * @brief The generated relational operators are sequestered here.
71 * Libstdc++ headers must not use the contents of `rel_ops`.
72 * User code should also avoid them, because unconstrained function
73 * templates are too greedy and can easily cause ambiguities.
75 * C++20 default comparisons are a better solution.
79 * @brief Defines @c != for arbitrary types, in terms of @c ==.
81 * @param __y Another thing.
84 * This function uses @c == to determine its result.
88 operator!=(const _Tp
& __x
, const _Tp
& __y
)
89 { return !(__x
== __y
); }
92 * @brief Defines @c > for arbitrary types, in terms of @c <.
94 * @param __y Another thing.
97 * This function uses @c < to determine its result.
101 operator>(const _Tp
& __x
, const _Tp
& __y
)
102 { return __y
< __x
; }
105 * @brief Defines @c <= for arbitrary types, in terms of @c <.
106 * @param __x A thing.
107 * @param __y Another thing.
110 * This function uses @c < to determine its result.
114 operator<=(const _Tp
& __x
, const _Tp
& __y
)
115 { return !(__y
< __x
); }
118 * @brief Defines @c >= for arbitrary types, in terms of @c <.
119 * @param __x A thing.
120 * @param __y Another thing.
123 * This function uses @c < to determine its result.
127 operator>=(const _Tp
& __x
, const _Tp
& __y
)
128 { return !(__x
< __y
); }
129 } // namespace rel_ops
131 _GLIBCXX_END_NAMESPACE_VERSION
134 #endif /* _STL_RELOPS_H */