## Introduction This patch implements `ranges::elements_of` from [P2502R2](https://wg21.link/P2502R2). Specializations of `elements_of` encapsulate a range and act as a tag in overload sets to disambiguate when a range should be treated as a sequence rather than a single value. ```cpp template <bool YieldElements> std::generator<std::any> f(std::ranges::input_range auto &&r) { if constexpr (YieldElements) { co_yield std::ranges::elements_of(r); } else { co_yield r; } } ``` ## Reference - [P2502R2: `std::generator`: Synchronous Coroutine Generator for Ranges](https://wg21.link/P2502R2) - [[range.elementsof]](https://eel.is/c++draft/range.elementsof) Partially addresses #105226 --------- Co-authored-by: Louis Dionne <ldionne.2@gmail.com> Co-authored-by: A. Jiang <de34@live.cn>
50 lines
1.3 KiB
C++
50 lines
1.3 KiB
C++
// -*- C++ -*-
|
|
//===----------------------------------------------------------------------===//
|
|
//
|
|
// 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___RANGES_ELEMENTS_OF_H
|
|
#define _LIBCPP___RANGES_ELEMENTS_OF_H
|
|
|
|
#include <__config>
|
|
#include <__cstddef/byte.h>
|
|
#include <__memory/allocator.h>
|
|
#include <__ranges/concepts.h>
|
|
#include <__utility/forward.h>
|
|
|
|
#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
|
|
# pragma GCC system_header
|
|
#endif
|
|
|
|
_LIBCPP_PUSH_MACROS
|
|
#include <__undef_macros>
|
|
|
|
_LIBCPP_BEGIN_NAMESPACE_STD
|
|
|
|
#if _LIBCPP_STD_VER >= 23
|
|
|
|
namespace ranges {
|
|
|
|
template <range _Range, class _Allocator = allocator<byte>>
|
|
struct elements_of {
|
|
_LIBCPP_NO_UNIQUE_ADDRESS _Range range;
|
|
_LIBCPP_NO_UNIQUE_ADDRESS _Allocator allocator = _Allocator();
|
|
};
|
|
|
|
template <class _Range, class _Allocator = allocator<byte>>
|
|
elements_of(_Range&&, _Allocator = _Allocator()) -> elements_of<_Range&&, _Allocator>;
|
|
|
|
} // namespace ranges
|
|
|
|
#endif // _LIBCPP_STD_VER >= 23
|
|
|
|
_LIBCPP_END_NAMESPACE_STD
|
|
|
|
_LIBCPP_POP_MACROS
|
|
|
|
#endif // _LIBCPP___RANGES_ELEMENTS_OF_H
|