1//===----------------------------------------------------------------------===//
2//
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
6//
7//===----------------------------------------------------------------------===//
8
9#ifndef _LIBCPP___ALGORITHM_CLAMP_H
10#define _LIBCPP___ALGORITHM_CLAMP_H
11
12#include <__algorithm/comp.h>
13#include <__assert>
14#include <__config>
15
16#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
17# pragma GCC system_header
18#endif
19
20#if _LIBCPP_STD_VER >= 17
21
22_LIBCPP_BEGIN_NAMESPACE_STD
23
24template <class _Tp, class _Compare>
25[[nodiscard]] inline _LIBCPP_HIDE_FROM_ABI constexpr const _Tp&
26clamp(_LIBCPP_LIFETIMEBOUND const _Tp& __v,
27 _LIBCPP_LIFETIMEBOUND const _Tp& __lo,
28 _LIBCPP_LIFETIMEBOUND const _Tp& __hi,
29 _Compare __comp) {
30 _LIBCPP_ASSERT_ARGUMENT_WITHIN_DOMAIN(!__comp(__hi, __lo), "Bad bounds passed to std::clamp");
31 return __comp(__v, __lo) ? __lo : __comp(__hi, __v) ? __hi : __v;
32}
33
34template <class _Tp>
35[[nodiscard]] inline _LIBCPP_HIDE_FROM_ABI constexpr const _Tp&
36clamp(_LIBCPP_LIFETIMEBOUND const _Tp& __v,
37 _LIBCPP_LIFETIMEBOUND const _Tp& __lo,
38 _LIBCPP_LIFETIMEBOUND const _Tp& __hi) {
39 return std::clamp(__v, __lo, __hi, __less<>());
40}
41
42_LIBCPP_END_NAMESPACE_STD
43
44#endif // _LIBCPP_STD_VER >= 17
45
46#endif // _LIBCPP___ALGORITHM_CLAMP_H
47