1 //===----------------------------------------------------------------------===//
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
7 //===----------------------------------------------------------------------===//
9 #ifndef _LIBCPP___ALGORITHM_RANGES_CLAMP_H
10 #define _LIBCPP___ALGORITHM_RANGES_CLAMP_H
14 #include <__functional/identity.h>
15 #include <__functional/invoke.h>
16 #include <__functional/ranges_operations.h>
17 #include <__iterator/concepts.h>
18 #include <__iterator/projected.h>
19 #include <__utility/forward.h>
21 #if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
22 # pragma GCC system_header
26 #include <__undef_macros>
28 #if _LIBCPP_STD_VER >= 20
30 _LIBCPP_BEGIN_NAMESPACE_STD
34 template <class _Type
,
35 class _Proj
= identity
,
36 indirect_strict_weak_order
<projected
<const _Type
*, _Proj
>> _Comp
= ranges::less
>
37 [[nodiscard
]] _LIBCPP_HIDE_FROM_ABI
constexpr const _Type
& operator()(
38 const _Type
& __value
, const _Type
& __low
, const _Type
& __high
, _Comp __comp
= {}, _Proj __proj
= {}) const {
39 _LIBCPP_ASSERT_ARGUMENT_WITHIN_DOMAIN(
40 !bool(std::invoke(__comp
, std::invoke(__proj
, __high
), std::invoke(__proj
, __low
))),
41 "Bad bounds passed to std::ranges::clamp");
43 auto&& __projected
= std::invoke(__proj
, __value
);
44 if (std::invoke(__comp
, std::forward
<decltype(__projected
)>(__projected
), std::invoke(__proj
, __low
)))
46 else if (std::invoke(__comp
, std::invoke(__proj
, __high
), std::forward
<decltype(__projected
)>(__projected
)))
53 inline namespace __cpo
{
54 inline constexpr auto clamp
= __clamp
{};
58 _LIBCPP_END_NAMESPACE_STD
60 #endif // _LIBCPP_STD_VER >= 20
64 #endif // _LIBCPP___ALGORITHM_RANGES_CLAMP_H