// Copyright (C) 2019-2024 Free Software Foundation, Inc.
//
// This file is part of the GNU ISO C++ Library. This library is free
// software; you can redistribute it and/or modify it under the
// terms of the GNU General Public License as published by the
// Free Software Foundation; either version 3, or (at your option)
// any later version.
// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
// You should have received a copy of the GNU General Public License along
// with this library; see the file COPYING3. If not see
// .
// { dg-do run { target c++20 } }
#include
#include
#include
static_assert(__gnu_test::is_customization_point_object(std::ranges::begin));
using std::same_as;
void
test01()
{
int a[2] = {};
static_assert(same_as);
static_assert(noexcept(std::ranges::begin(a)));
VERIFY( std::ranges::begin(a) == (a + 0) );
constexpr long b[2] = { };
static_assert( std::ranges::begin(b) == (b + 0) );
struct X { };
using A = X[]; // unbounded array
extern A& f();
static_assert( same_as );
}
void
test02()
{
using __gnu_test::test_range;
using __gnu_test::random_access_iterator_wrapper;
using __gnu_test::input_iterator_wrapper;
using __gnu_test::output_iterator_wrapper;
int a[] = { 0, 1 };
test_range r(a);
static_assert(same_as);
VERIFY( std::ranges::begin(r) == r.begin() );
test_range i(a);
static_assert(same_as);
VERIFY( std::ranges::begin(i) == i.begin() );
test_range o(a);
static_assert(same_as);
*std::ranges::begin(o) = 99;
VERIFY( a[0] == 99 );
}
struct R
{
int a[4] = { 0, 1, 2, 3 };
friend int* begin(R& r) { return r.a + 0; }
friend int* begin(R&& r); // this overload is not defined
friend const int* begin(const R& r) noexcept { return r.a + 2; }
friend const int* begin(const R&& r) noexcept; // not defined
};
struct RV // view on an R
{
R& r;
friend int* begin(RV& rv) { return begin(rv.r); }
friend const int* begin(const RV& rv) noexcept { return begin(rv.r); }
};
// Allow ranges::begin to work with RV&&
template<> constexpr bool std::ranges::enable_borrowed_range = true;
void
test03()
{
R r;
const R& c = r;
static_assert(same_as);
static_assert(!noexcept(std::ranges::begin(r)));
VERIFY( std::ranges::begin(r) == begin(r) );
static_assert(same_as);
static_assert(noexcept(std::ranges::begin(c)));
VERIFY( std::ranges::begin(c) == begin(c) );
RV v{r};
// enable_borrowed_range allows ranges::begin to work for rvalues,
// but it will call v.begin() or begin(v) on an lvalue:
static_assert(same_as);
static_assert(!noexcept(std::ranges::begin(std::move(v))));
VERIFY( std::ranges::begin(std::move(v)) == begin(v) );
const RV cv{r};
static_assert(same_as);
static_assert(noexcept(std::ranges::begin(std::move(cv))));
VERIFY( std::ranges::begin(std::move(cv)) == begin(cv) );
}
struct RR
{
short s = 0;
long l = 0;
int a[4] = { 0, 1, 2, 3 };
short* begin() noexcept { return &s; }
const long* begin() const { return &l; }
friend int* begin(RR& r) noexcept { return r.a + 0; }
friend int* begin(RR&& r); // not defined
friend const int* begin(const RR& r) { return r.a + 2; }
friend const int* begin(const RR&& r) noexcept; // not defined
};
// N.B. this is a lie, begin on an RR rvalue will return a dangling pointer.
template<> constexpr bool std::ranges::enable_borrowed_range = true;
void
test04()
{
RR r;
const RR& c = r;
VERIFY( std::ranges::begin(r) == &r.s );
static_assert(noexcept(std::ranges::begin(r)));
// calls r.begin() on an lvalue, not rvalue
VERIFY( std::ranges::begin(std::move(r)) == std::ranges::begin(r) );
static_assert(noexcept(std::ranges::begin(std::move(r))));
VERIFY( std::ranges::begin(c) == &r.l );
static_assert(!noexcept(std::ranges::begin(c)));
// calls r.begin() on a const lvalue, not rvalue
VERIFY( std::ranges::begin(std::move(c)) == std::ranges::begin(c) );
static_assert(!noexcept(std::ranges::begin(std::move(c))));
}
int
main()
{
test01();
test02();
test03();
test04();
}