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_LIBCPP_BEGIN_NAMESPACE_STD
21
22#if _LIBCPP_STD_VER >= 17
23template <class _Tp, class _Compare>
24_LIBCPP_NODISCARD_EXT inline _LIBCPP_HIDE_FROM_ABI constexpr const _Tp&
25clamp(_LIBCPP_LIFETIMEBOUND const _Tp& __v,
26      _LIBCPP_LIFETIMEBOUND const _Tp& __lo,
27      _LIBCPP_LIFETIMEBOUND const _Tp& __hi,
28      _Compare __comp) {
29  _LIBCPP_ASSERT_ARGUMENT_WITHIN_DOMAIN(!__comp(__hi, __lo), "Bad bounds passed to std::clamp");
30  return __comp(__v, __lo) ? __lo : __comp(__hi, __v) ? __hi : __v;
31}
32
33template <class _Tp>
34_LIBCPP_NODISCARD_EXT inline _LIBCPP_HIDE_FROM_ABI constexpr const _Tp&
35clamp(_LIBCPP_LIFETIMEBOUND const _Tp& __v,
36      _LIBCPP_LIFETIMEBOUND const _Tp& __lo,
37      _LIBCPP_LIFETIMEBOUND const _Tp& __hi) {
38  return std::clamp(__v, __lo, __hi, __less<>());
39}
40#endif
41
42_LIBCPP_END_NAMESPACE_STD
43
44#endif // _LIBCPP___ALGORITHM_CLAMP_H
45