[libcxx-commits] [libcxx] [libcxx] Implement `std::constant_wrapper` (PR #191695)
Louis Dionne via libcxx-commits
libcxx-commits at lists.llvm.org
Fri Apr 17 11:06:13 PDT 2026
================
@@ -0,0 +1,338 @@
+//===----------------------------------------------------------------------===//
+//
+// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
+// See https://llvm.org/LICENSE.txt for license information.
+// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
+//
+//===----------------------------------------------------------------------===//
+
+#ifndef _LIBCPP___UTILITY_CONSTANT_WRAPPER_H
+#define _LIBCPP___UTILITY_CONSTANT_WRAPPER_H
+
+#include <__config>
+#include <__cstddef/size_t.h>
+#include <__functional/invoke.h>
+#include <__type_traits/is_constructible.h>
+#include <__type_traits/remove_cvref.h>
+#include <__utility/forward.h>
+#include <__utility/integer_sequence.h>
+
+#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
+# pragma GCC system_header
+#endif
+
+_LIBCPP_BEGIN_NAMESPACE_STD
+
+#if _LIBCPP_STD_VER >= 26
+
+template <class _Tp>
+struct __cw_fixed_value {
+ using __type _LIBCPP_NODEBUG = _Tp;
+ _LIBCPP_HIDE_FROM_ABI constexpr __cw_fixed_value(__type __v) noexcept : __data(__v) {}
+ _Tp __data;
+};
+
+template <__cw_fixed_value _Xp,
+# ifdef _LIBCPP_COMPILER_GCC
+ // gcc bug: https://gcc.gnu.org/PR117392
+ class = typename decltype(__cw_fixed_value(_Xp))::__type
+# else
+ class = typename decltype(_Xp)::__type
+# endif
+ >
+struct constant_wrapper;
+
+template <class _Tp>
+concept __constexpr_param = requires { typename constant_wrapper<_Tp::value>; };
+
+template <__cw_fixed_value _Xp>
+constexpr auto cw = constant_wrapper<_Xp>{};
+
+template <class _Tp, size_t _Extent>
+struct __cw_fixed_value<_Tp[_Extent]> {
+ using __type _LIBCPP_NODEBUG = _Tp[_Extent];
+ _Tp __data[_Extent];
+
+ _LIBCPP_HIDE_FROM_ABI constexpr __cw_fixed_value(_Tp (&__arr)[_Extent]) noexcept
+ : __cw_fixed_value(__arr, make_index_sequence<_Extent>{}) {}
+
+private:
+ template <size_t... _Idxs>
+ _LIBCPP_HIDE_FROM_ABI constexpr __cw_fixed_value(_Tp (&__arr)[_Extent], index_sequence<_Idxs...>) noexcept
+ : __data{__arr[_Idxs]...} {}
+};
+
+template <class _Tp, size_t _Extent>
+__cw_fixed_value(_Tp (&)[_Extent]) -> __cw_fixed_value<_Tp[_Extent]>;
+
+struct __cw_operators {
+ // unary operators
+ template <__constexpr_param _Tp>
+ _LIBCPP_HIDE_FROM_ABI friend constexpr auto operator+(_Tp) noexcept -> constant_wrapper<(+_Tp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Tp>
+ _LIBCPP_HIDE_FROM_ABI friend constexpr auto operator-(_Tp) noexcept -> constant_wrapper<(-_Tp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Tp>
+ _LIBCPP_HIDE_FROM_ABI friend constexpr auto operator~(_Tp) noexcept -> constant_wrapper<(~_Tp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Tp>
+ _LIBCPP_HIDE_FROM_ABI friend constexpr auto operator!(_Tp) noexcept -> constant_wrapper<(!_Tp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Tp>
+ _LIBCPP_HIDE_FROM_ABI friend constexpr auto operator&(_Tp) noexcept -> constant_wrapper<(&_Tp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Tp>
+ _LIBCPP_HIDE_FROM_ABI friend constexpr auto operator*(_Tp) noexcept -> constant_wrapper<(*_Tp::value)> {
+ return {};
+ }
+
+ // binary operators
+ template <__constexpr_param _Lp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI friend constexpr auto operator+(_Lp, _Rp) noexcept
+ -> constant_wrapper<(_Lp::value + _Rp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Lp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI friend constexpr auto operator-(_Lp, _Rp) noexcept
+ -> constant_wrapper<(_Lp::value - _Rp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Lp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI friend constexpr auto operator*(_Lp, _Rp) noexcept
+ -> constant_wrapper<(_Lp::value * _Rp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Lp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI friend constexpr auto operator/(_Lp, _Rp) noexcept
+ -> constant_wrapper<(_Lp::value / _Rp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Lp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI friend constexpr auto operator%(_Lp, _Rp) noexcept
+ -> constant_wrapper<(_Lp::value % _Rp::value)> {
+ return {};
+ }
+
+ template <__constexpr_param _Lp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI friend constexpr auto operator<<(_Lp, _Rp) noexcept
+ -> constant_wrapper<(_Lp::value << _Rp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Lp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI friend constexpr auto operator>>(_Lp, _Rp) noexcept
+ -> constant_wrapper<(_Lp::value >> _Rp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Lp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI friend constexpr auto operator&(_Lp, _Rp) noexcept
+ -> constant_wrapper<(_Lp::value & _Rp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Lp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI friend constexpr auto operator|(_Lp, _Rp) noexcept
+ -> constant_wrapper<(_Lp::value | _Rp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Lp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI friend constexpr auto operator^(_Lp, _Rp) noexcept
+ -> constant_wrapper<(_Lp::value ^ _Rp::value)> {
+ return {};
+ }
+
+ template <__constexpr_param _Lp, __constexpr_param _Rp>
+ requires(!is_constructible_v<bool, decltype(_Lp::value)> || !is_constructible_v<bool, decltype(_Rp::value)>)
+ _LIBCPP_HIDE_FROM_ABI friend constexpr auto operator&&(_Lp, _Rp) noexcept
+ -> constant_wrapper<(_Lp::value && _Rp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Lp, __constexpr_param _Rp>
+ requires(!is_constructible_v<bool, decltype(_Lp::value)> || !is_constructible_v<bool, decltype(_Rp::value)>)
+ _LIBCPP_HIDE_FROM_ABI friend constexpr auto operator||(_Lp, _Rp) noexcept
+ -> constant_wrapper<(_Lp::value || _Rp::value)> {
+ return {};
+ }
+
+ // comparisons
+ template <__constexpr_param _Lp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI friend constexpr auto operator<=>(_Lp, _Rp) noexcept
+ -> constant_wrapper<(_Lp::value <=> _Rp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Lp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI friend constexpr auto operator<(_Lp, _Rp) noexcept
+ -> constant_wrapper<(_Lp::value < _Rp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Lp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI friend constexpr auto operator<=(_Lp, _Rp) noexcept
+ -> constant_wrapper<(_Lp::value <= _Rp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Lp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI friend constexpr auto operator==(_Lp, _Rp) noexcept
+ -> constant_wrapper<(_Lp::value == _Rp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Lp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI friend constexpr auto operator!=(_Lp, _Rp) noexcept
+ -> constant_wrapper<(_Lp::value != _Rp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Lp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI friend constexpr auto operator>(_Lp, _Rp) noexcept
+ -> constant_wrapper<(_Lp::value > _Rp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Lp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI friend constexpr auto operator>=(_Lp, _Rp) noexcept
+ -> constant_wrapper<(_Lp::value >= _Rp::value)> {
+ return {};
+ }
+
+ template <__constexpr_param _Lp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI friend constexpr auto operator,(_Lp, _Rp) noexcept = delete;
+ template <__constexpr_param _Lp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI friend constexpr auto operator->*(_Lp, _Rp) noexcept
+ -> constant_wrapper<_Lp::value->*(_Rp::value)> {
+ return {};
+ }
+
+ // pseudo-mutators
+ template <__constexpr_param _Tp>
+ _LIBCPP_HIDE_FROM_ABI constexpr auto operator++(this _Tp) noexcept -> constant_wrapper<++(_Tp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Tp>
+ _LIBCPP_HIDE_FROM_ABI constexpr auto operator++(this _Tp, int) noexcept -> constant_wrapper<(_Tp::value++)> {
+ return {};
+ }
+ template <__constexpr_param _Tp>
+ _LIBCPP_HIDE_FROM_ABI constexpr auto operator--(this _Tp) noexcept -> constant_wrapper<--(_Tp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Tp>
+ _LIBCPP_HIDE_FROM_ABI constexpr auto operator--(this _Tp, int) noexcept -> constant_wrapper<(_Tp::value--)> {
+ return {};
+ }
+
+ template <__constexpr_param _Tp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI constexpr auto operator+=(this _Tp, _Rp) noexcept
+ -> constant_wrapper<(_Tp::value += _Rp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Tp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI constexpr auto operator-=(this _Tp, _Rp) noexcept
+ -> constant_wrapper<(_Tp::value -= _Rp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Tp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI constexpr auto operator*=(this _Tp, _Rp) noexcept
+ -> constant_wrapper<(_Tp::value *= _Rp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Tp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI constexpr auto operator/=(this _Tp, _Rp) noexcept
+ -> constant_wrapper<(_Tp::value /= _Rp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Tp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI constexpr auto operator%=(this _Tp, _Rp) noexcept
+ -> constant_wrapper<(_Tp::value %= _Rp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Tp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI constexpr auto operator&=(this _Tp, _Rp) noexcept
+ -> constant_wrapper<(_Tp::value &= _Rp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Tp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI constexpr auto operator|=(this _Tp, _Rp) noexcept
+ -> constant_wrapper<(_Tp::value |= _Rp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Tp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI constexpr auto operator^=(this _Tp, _Rp) noexcept
+ -> constant_wrapper<(_Tp::value ^= _Rp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Tp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI constexpr auto operator<<=(this _Tp, _Rp) noexcept
+ -> constant_wrapper<(_Tp::value <<= _Rp::value)> {
+ return {};
+ }
+ template <__constexpr_param _Tp, __constexpr_param _Rp>
+ _LIBCPP_HIDE_FROM_ABI constexpr auto operator>>=(this _Tp, _Rp) noexcept
+ -> constant_wrapper<(_Tp::value >>= _Rp::value)> {
+ return {};
+ }
+};
+
+template <__cw_fixed_value _Xp, class>
+struct constant_wrapper : __cw_operators {
----------------
ldionne wrote:
As discussed, I'd be curious to know why we need to use `__cw_operators` at all to implement this. Not that I care strongly, but it doesn't seem like the natural way to implement this.
https://github.com/llvm/llvm-project/pull/191695
More information about the libcxx-commits
mailing list