/* * Copyright 2015 The WebRTC Project Authors. All rights reserved. * * Use of this source code is governed by a BSD-style license * that can be found in the LICENSE file in the root of the source * tree. An additional intellectual property rights grant can be found * in the file PATENTS. All contributing project authors may * be found in the AUTHORS file in the root of the source tree. */ #include "api/array_view.h" #include #include #include #include #include #include "rtc_base/buffer.h" #include "rtc_base/checks.h" #include "rtc_base/gunit.h" #include "test/gmock.h" namespace rtc { namespace { using ::testing::ElementsAre; using ::testing::IsEmpty; template size_t Call(ArrayView av) { return av.size(); } template void CallFixed(ArrayView av) {} } // namespace TEST(ArrayViewDeathTest, TestConstructFromPtrAndArray) { char arr[] = "Arrr!"; const char carr[] = "Carrr!"; EXPECT_EQ(6u, Call(arr)); EXPECT_EQ(7u, Call(carr)); EXPECT_EQ(6u, Call(arr)); // Call(carr); // Compile error, because can't drop const. // Call(arr); // Compile error, because incompatible types. ArrayView x; EXPECT_EQ(0u, x.size()); EXPECT_EQ(nullptr, x.data()); ArrayView y = arr; EXPECT_EQ(6u, y.size()); EXPECT_EQ(arr, y.data()); ArrayView yf = arr; static_assert(yf.size() == 6, ""); EXPECT_EQ(arr, yf.data()); ArrayView z(arr + 1, 3); EXPECT_EQ(3u, z.size()); EXPECT_EQ(arr + 1, z.data()); ArrayView zf(arr + 1, 3); static_assert(zf.size() == 3, ""); EXPECT_EQ(arr + 1, zf.data()); ArrayView w(arr, 2); EXPECT_EQ(2u, w.size()); EXPECT_EQ(arr, w.data()); ArrayView wf(arr, 2); static_assert(wf.size() == 2, ""); EXPECT_EQ(arr, wf.data()); ArrayView q(arr, 0); EXPECT_EQ(0u, q.size()); EXPECT_EQ(nullptr, q.data()); ArrayView qf(arr, 0); static_assert(qf.size() == 0, ""); EXPECT_EQ(nullptr, qf.data()); #if RTC_DCHECK_IS_ON && GTEST_HAS_DEATH_TEST && !defined(WEBRTC_ANDROID) // DCHECK error (nullptr with nonzero size). EXPECT_DEATH(ArrayView(static_cast(nullptr), 5), ""); #endif // These are compile errors, because incompatible types. // ArrayView m = arr; // ArrayView n(arr + 2, 2); } TEST(ArrayViewTest, TestCopyConstructorVariableLvalue) { char arr[] = "Arrr!"; ArrayView x = arr; EXPECT_EQ(6u, x.size()); EXPECT_EQ(arr, x.data()); ArrayView y = x; // Copy non-const -> non-const. EXPECT_EQ(6u, y.size()); EXPECT_EQ(arr, y.data()); ArrayView z = x; // Copy non-const -> const. EXPECT_EQ(6u, z.size()); EXPECT_EQ(arr, z.data()); ArrayView w = z; // Copy const -> const. EXPECT_EQ(6u, w.size()); EXPECT_EQ(arr, w.data()); // ArrayView v = z; // Compile error, because can't drop const. } TEST(ArrayViewTest, TestCopyConstructorVariableRvalue) { char arr[] = "Arrr!"; ArrayView x = arr; EXPECT_EQ(6u, x.size()); EXPECT_EQ(arr, x.data()); ArrayView y = std::move(x); // Copy non-const -> non-const. EXPECT_EQ(6u, y.size()); EXPECT_EQ(arr, y.data()); ArrayView z = std::move(x); // Copy non-const -> const. EXPECT_EQ(6u, z.size()); EXPECT_EQ(arr, z.data()); ArrayView w = std::move(z); // Copy const -> const. EXPECT_EQ(6u, w.size()); EXPECT_EQ(arr, w.data()); // ArrayView v = std::move(z); // Error, because can't drop const. } TEST(ArrayViewTest, TestCopyConstructorFixedLvalue) { char arr[] = "Arrr!"; ArrayView x = arr; static_assert(x.size() == 6, ""); EXPECT_EQ(arr, x.data()); // Copy fixed -> fixed. ArrayView y = x; // Copy non-const -> non-const. static_assert(y.size() == 6, ""); EXPECT_EQ(arr, y.data()); ArrayView z = x; // Copy non-const -> const. static_assert(z.size() == 6, ""); EXPECT_EQ(arr, z.data()); ArrayView w = z; // Copy const -> const. static_assert(w.size() == 6, ""); EXPECT_EQ(arr, w.data()); // ArrayView v = z; // Compile error, because can't drop const. // Copy fixed -> variable. ArrayView yv = x; // Copy non-const -> non-const. EXPECT_EQ(6u, yv.size()); EXPECT_EQ(arr, yv.data()); ArrayView zv = x; // Copy non-const -> const. EXPECT_EQ(6u, zv.size()); EXPECT_EQ(arr, zv.data()); ArrayView wv = z; // Copy const -> const. EXPECT_EQ(6u, wv.size()); EXPECT_EQ(arr, wv.data()); // ArrayView vv = z; // Compile error, because can't drop const. } TEST(ArrayViewTest, TestCopyConstructorFixedRvalue) { char arr[] = "Arrr!"; ArrayView x = arr; static_assert(x.size() == 6, ""); EXPECT_EQ(arr, x.data()); // Copy fixed -> fixed. ArrayView y = std::move(x); // Copy non-const -> non-const. static_assert(y.size() == 6, ""); EXPECT_EQ(arr, y.data()); ArrayView z = std::move(x); // Copy non-const -> const. static_assert(z.size() == 6, ""); EXPECT_EQ(arr, z.data()); ArrayView w = std::move(z); // Copy const -> const. static_assert(w.size() == 6, ""); EXPECT_EQ(arr, w.data()); // ArrayView v = std::move(z); // Error, because can't drop const. // Copy fixed -> variable. ArrayView yv = std::move(x); // Copy non-const -> non-const. EXPECT_EQ(6u, yv.size()); EXPECT_EQ(arr, yv.data()); ArrayView zv = std::move(x); // Copy non-const -> const. EXPECT_EQ(6u, zv.size()); EXPECT_EQ(arr, zv.data()); ArrayView wv = std::move(z); // Copy const -> const. EXPECT_EQ(6u, wv.size()); EXPECT_EQ(arr, wv.data()); // ArrayView vv = std::move(z); // Error, because can't drop const. } TEST(ArrayViewTest, TestCopyAssignmentVariableLvalue) { char arr[] = "Arrr!"; ArrayView x(arr); EXPECT_EQ(6u, x.size()); EXPECT_EQ(arr, x.data()); ArrayView y; y = x; // Copy non-const -> non-const. EXPECT_EQ(6u, y.size()); EXPECT_EQ(arr, y.data()); ArrayView z; z = x; // Copy non-const -> const. EXPECT_EQ(6u, z.size()); EXPECT_EQ(arr, z.data()); ArrayView w; w = z; // Copy const -> const. EXPECT_EQ(6u, w.size()); EXPECT_EQ(arr, w.data()); // ArrayView v; // v = z; // Compile error, because can't drop const. } TEST(ArrayViewTest, TestCopyAssignmentVariableRvalue) { char arr[] = "Arrr!"; ArrayView x(arr); EXPECT_EQ(6u, x.size()); EXPECT_EQ(arr, x.data()); ArrayView y; y = std::move(x); // Copy non-const -> non-const. EXPECT_EQ(6u, y.size()); EXPECT_EQ(arr, y.data()); ArrayView z; z = std::move(x); // Copy non-const -> const. EXPECT_EQ(6u, z.size()); EXPECT_EQ(arr, z.data()); ArrayView w; w = std::move(z); // Copy const -> const. EXPECT_EQ(6u, w.size()); EXPECT_EQ(arr, w.data()); // ArrayView v; // v = std::move(z); // Compile error, because can't drop const. } TEST(ArrayViewTest, TestCopyAssignmentFixedLvalue) { char arr[] = "Arrr!"; char init[] = "Init!"; ArrayView x(arr); EXPECT_EQ(arr, x.data()); // Copy fixed -> fixed. ArrayView y(init); y = x; // Copy non-const -> non-const. EXPECT_EQ(arr, y.data()); ArrayView z(init); z = x; // Copy non-const -> const. EXPECT_EQ(arr, z.data()); ArrayView w(init); w = z; // Copy const -> const. EXPECT_EQ(arr, w.data()); // ArrayView v(init); // v = z; // Compile error, because can't drop const. // Copy fixed -> variable. ArrayView yv; yv = x; // Copy non-const -> non-const. EXPECT_EQ(6u, yv.size()); EXPECT_EQ(arr, yv.data()); ArrayView zv; zv = x; // Copy non-const -> const. EXPECT_EQ(6u, zv.size()); EXPECT_EQ(arr, zv.data()); ArrayView wv; wv = z; // Copy const -> const. EXPECT_EQ(6u, wv.size()); EXPECT_EQ(arr, wv.data()); // ArrayView v; // v = z; // Compile error, because can't drop const. } TEST(ArrayViewTest, TestCopyAssignmentFixedRvalue) { char arr[] = "Arrr!"; char init[] = "Init!"; ArrayView x(arr); EXPECT_EQ(arr, x.data()); // Copy fixed -> fixed. ArrayView y(init); y = std::move(x); // Copy non-const -> non-const. EXPECT_EQ(arr, y.data()); ArrayView z(init); z = std::move(x); // Copy non-const -> const. EXPECT_EQ(arr, z.data()); ArrayView w(init); w = std::move(z); // Copy const -> const. EXPECT_EQ(arr, w.data()); // ArrayView v(init); // v = std::move(z); // Compile error, because can't drop const. // Copy fixed -> variable. ArrayView yv; yv = std::move(x); // Copy non-const -> non-const. EXPECT_EQ(6u, yv.size()); EXPECT_EQ(arr, yv.data()); ArrayView zv; zv = std::move(x); // Copy non-const -> const. EXPECT_EQ(6u, zv.size()); EXPECT_EQ(arr, zv.data()); ArrayView wv; wv = std::move(z); // Copy const -> const. EXPECT_EQ(6u, wv.size()); EXPECT_EQ(arr, wv.data()); // ArrayView v; // v = std::move(z); // Compile error, because can't drop const. } TEST(ArrayViewTest, TestStdArray) { EXPECT_EQ(4u, Call(std::array{1, 2, 3, 4})); CallFixed(std::array{2, 3, 4}); constexpr size_t size = 5; std::array arr{}; // Fixed size view. rtc::ArrayView arr_view_fixed(arr); EXPECT_EQ(arr.data(), arr_view_fixed.data()); static_assert(size == arr_view_fixed.size(), ""); // Variable size view. rtc::ArrayView arr_view(arr); EXPECT_EQ(arr.data(), arr_view.data()); EXPECT_EQ(size, arr_view.size()); } TEST(ArrayViewTest, TestConstStdArray) { constexpr size_t size = 5; constexpr std::array constexpr_arr{}; rtc::ArrayView constexpr_arr_view(constexpr_arr); EXPECT_EQ(constexpr_arr.data(), constexpr_arr_view.data()); static_assert(constexpr_arr.size() == constexpr_arr_view.size(), ""); const std::array const_arr{}; rtc::ArrayView const_arr_view(const_arr); EXPECT_EQ(const_arr.data(), const_arr_view.data()); static_assert(const_arr.size() == const_arr_view.size(), ""); std::array non_const_arr{}; rtc::ArrayView non_const_arr_view(non_const_arr); EXPECT_EQ(non_const_arr.data(), non_const_arr_view.data()); static_assert(non_const_arr.size() == non_const_arr_view.size(), ""); } TEST(ArrayViewTest, TestStdVector) { EXPECT_EQ(3u, Call(std::vector{4, 5, 6})); std::vector v; v.push_back(3); v.push_back(11); EXPECT_EQ(2u, Call(v)); EXPECT_EQ(2u, Call(v)); // Call(v); // Compile error, because incompatible types. ArrayView x = v; EXPECT_EQ(2u, x.size()); EXPECT_EQ(v.data(), x.data()); ArrayView y; y = v; EXPECT_EQ(2u, y.size()); EXPECT_EQ(v.data(), y.data()); // ArrayView d = v; // Compile error, because incompatible types. const std::vector cv; EXPECT_EQ(0u, Call(cv)); // Call(cv); // Compile error, because can't drop const. ArrayView z = cv; EXPECT_EQ(0u, z.size()); EXPECT_EQ(nullptr, z.data()); // ArrayView w = cv; // Compile error, because can't drop const. } TEST(ArrayViewTest, TestRtcBuffer) { rtc::Buffer b = "so buffer"; EXPECT_EQ(10u, Call(b)); EXPECT_EQ(10u, Call(b)); // Call(b); // Compile error, because incompatible types. ArrayView x = b; EXPECT_EQ(10u, x.size()); EXPECT_EQ(b.data(), x.data()); ArrayView y; y = b; EXPECT_EQ(10u, y.size()); EXPECT_EQ(b.data(), y.data()); // ArrayView d = b; // Compile error, because incompatible types. const rtc::Buffer cb = "very const"; EXPECT_EQ(11u, Call(cb)); // Call(cb); // Compile error, because can't drop const. ArrayView z = cb; EXPECT_EQ(11u, z.size()); EXPECT_EQ(cb.data(), z.data()); // ArrayView w = cb; // Compile error, because can't drop const. } TEST(ArrayViewTest, TestSwapVariable) { const char arr[] = "Arrr!"; const char aye[] = "Aye, Cap'n!"; ArrayView x(arr); EXPECT_EQ(6u, x.size()); EXPECT_EQ(arr, x.data()); ArrayView y(aye); EXPECT_EQ(12u, y.size()); EXPECT_EQ(aye, y.data()); using std::swap; swap(x, y); EXPECT_EQ(12u, x.size()); EXPECT_EQ(aye, x.data()); EXPECT_EQ(6u, y.size()); EXPECT_EQ(arr, y.data()); // ArrayView z; // swap(x, z); // Compile error, because can't drop const. } TEST(FixArrayViewTest, TestSwapFixed) { const char arr[] = "Arr!"; char aye[] = "Aye!"; ArrayView x(arr); EXPECT_EQ(arr, x.data()); ArrayView y(aye); EXPECT_EQ(aye, y.data()); using std::swap; swap(x, y); EXPECT_EQ(aye, x.data()); EXPECT_EQ(arr, y.data()); // ArrayView z(aye); // swap(x, z); // Compile error, because can't drop const. // ArrayView w(aye, 4); // swap(x, w); // Compile error, because different sizes. } TEST(ArrayViewDeathTest, TestIndexing) { char arr[] = "abcdefg"; ArrayView x(arr); const ArrayView y(arr); ArrayView z(arr); EXPECT_EQ(8u, x.size()); EXPECT_EQ(8u, y.size()); EXPECT_EQ(8u, z.size()); EXPECT_EQ('b', x[1]); EXPECT_EQ('c', y[2]); EXPECT_EQ('d', z[3]); x[3] = 'X'; y[2] = 'Y'; // z[1] = 'Z'; // Compile error, because z's element type is const char. EXPECT_EQ('b', x[1]); EXPECT_EQ('Y', y[2]); EXPECT_EQ('X', z[3]); #if RTC_DCHECK_IS_ON && GTEST_HAS_DEATH_TEST && !defined(WEBRTC_ANDROID) EXPECT_DEATH(z[8], ""); // DCHECK error (index out of bounds). #endif } TEST(ArrayViewTest, TestIterationEmpty) { // Variable-size. ArrayView>>> av; EXPECT_EQ(av.begin(), av.end()); EXPECT_EQ(av.cbegin(), av.cend()); for (auto& e : av) { EXPECT_TRUE(false); EXPECT_EQ(42u, e.size()); // Dummy use of e to prevent unused var warning. } // Fixed-size. ArrayView>>, 0> af; EXPECT_EQ(af.begin(), af.end()); EXPECT_EQ(af.cbegin(), af.cend()); for (auto& e : af) { EXPECT_TRUE(false); EXPECT_EQ(42u, e.size()); // Dummy use of e to prevent unused var warning. } } TEST(ArrayViewTest, TestReverseIterationEmpty) { // Variable-size. ArrayView>>> av; EXPECT_EQ(av.rbegin(), av.rend()); EXPECT_EQ(av.crbegin(), av.crend()); EXPECT_TRUE(av.empty()); // Fixed-size. ArrayView>>, 0> af; EXPECT_EQ(af.begin(), af.end()); EXPECT_EQ(af.cbegin(), af.cend()); EXPECT_TRUE(af.empty()); } TEST(ArrayViewTest, TestIterationVariable) { char arr[] = "Arrr!"; ArrayView av(arr); EXPECT_EQ('A', *av.begin()); EXPECT_EQ('A', *av.cbegin()); EXPECT_EQ('\0', *(av.end() - 1)); EXPECT_EQ('\0', *(av.cend() - 1)); char i = 0; for (auto& e : av) { EXPECT_EQ(arr + i, &e); e = 's' + i; ++i; } i = 0; for (auto& e : ArrayView(av)) { EXPECT_EQ(arr + i, &e); // e = 'q' + i; // Compile error, because e is a const char&. ++i; } } TEST(ArrayViewTest, TestReverseIterationVariable) { char arr[] = "Arrr!"; ArrayView av(arr); EXPECT_EQ('\0', *av.rbegin()); EXPECT_EQ('\0', *av.crbegin()); EXPECT_EQ('A', *(av.rend() - 1)); EXPECT_EQ('A', *(av.crend() - 1)); const char* cit = av.cend() - 1; for (auto crit = av.crbegin(); crit != av.crend(); ++crit, --cit) { EXPECT_EQ(*cit, *crit); } char* it = av.end() - 1; for (auto rit = av.rbegin(); rit != av.rend(); ++rit, --it) { EXPECT_EQ(*it, *rit); } } TEST(ArrayViewTest, TestIterationFixed) { char arr[] = "Arrr!"; ArrayView av(arr); EXPECT_EQ('A', *av.begin()); EXPECT_EQ('A', *av.cbegin()); EXPECT_EQ('\0', *(av.end() - 1)); EXPECT_EQ('\0', *(av.cend() - 1)); char i = 0; for (auto& e : av) { EXPECT_EQ(arr + i, &e); e = 's' + i; ++i; } i = 0; for (auto& e : ArrayView(av)) { EXPECT_EQ(arr + i, &e); // e = 'q' + i; // Compile error, because e is a const char&. ++i; } } TEST(ArrayViewTest, TestReverseIterationFixed) { char arr[] = "Arrr!"; ArrayView av(arr); EXPECT_EQ('\0', *av.rbegin()); EXPECT_EQ('\0', *av.crbegin()); EXPECT_EQ('A', *(av.rend() - 1)); EXPECT_EQ('A', *(av.crend() - 1)); const char* cit = av.cend() - 1; for (auto crit = av.crbegin(); crit != av.crend(); ++crit, --cit) { EXPECT_EQ(*cit, *crit); } char* it = av.end() - 1; for (auto rit = av.rbegin(); rit != av.rend(); ++rit, --it) { EXPECT_EQ(*it, *rit); } } TEST(ArrayViewTest, TestEmpty) { EXPECT_TRUE(ArrayView().empty()); const int a[] = {1, 2, 3}; EXPECT_FALSE(ArrayView(a).empty()); static_assert(ArrayView::empty(), ""); static_assert(!ArrayView::empty(), ""); } TEST(ArrayViewTest, TestCompare) { int a[] = {1, 2, 3}; int b[] = {1, 2, 3}; EXPECT_EQ(ArrayView(a), ArrayView(a)); EXPECT_EQ((ArrayView(a)), (ArrayView(a))); EXPECT_EQ(ArrayView(a), (ArrayView(a))); EXPECT_EQ(ArrayView(), ArrayView()); EXPECT_EQ(ArrayView(), ArrayView(a, 0)); EXPECT_EQ(ArrayView(a, 0), ArrayView(b, 0)); EXPECT_EQ((ArrayView(a, 0)), ArrayView()); EXPECT_NE(ArrayView(a), ArrayView(b)); EXPECT_NE((ArrayView(a)), (ArrayView(b))); EXPECT_NE((ArrayView(a)), ArrayView(b)); EXPECT_NE(ArrayView(a), ArrayView()); EXPECT_NE(ArrayView(a), ArrayView(a, 2)); EXPECT_NE((ArrayView(a)), (ArrayView(a, 2))); } TEST(ArrayViewTest, TestSubViewVariable) { int a[] = {1, 2, 3}; ArrayView av(a); EXPECT_EQ(av.subview(0), av); EXPECT_THAT(av.subview(1), ElementsAre(2, 3)); EXPECT_THAT(av.subview(2), ElementsAre(3)); EXPECT_THAT(av.subview(3), IsEmpty()); EXPECT_THAT(av.subview(4), IsEmpty()); EXPECT_THAT(av.subview(1, 0), IsEmpty()); EXPECT_THAT(av.subview(1, 1), ElementsAre(2)); EXPECT_THAT(av.subview(1, 2), ElementsAre(2, 3)); EXPECT_THAT(av.subview(1, 3), ElementsAre(2, 3)); } TEST(ArrayViewTest, TestSubViewFixed) { int a[] = {1, 2, 3}; ArrayView av(a); EXPECT_EQ(av.subview(0), av); EXPECT_THAT(av.subview(1), ElementsAre(2, 3)); EXPECT_THAT(av.subview(2), ElementsAre(3)); EXPECT_THAT(av.subview(3), IsEmpty()); EXPECT_THAT(av.subview(4), IsEmpty()); EXPECT_THAT(av.subview(1, 0), IsEmpty()); EXPECT_THAT(av.subview(1, 1), ElementsAre(2)); EXPECT_THAT(av.subview(1, 2), ElementsAre(2, 3)); EXPECT_THAT(av.subview(1, 3), ElementsAre(2, 3)); } TEST(ArrayViewTest, TestReinterpretCastFixedSize) { uint8_t bytes[] = {1, 2, 3}; ArrayView uint8_av(bytes); ArrayView int8_av = reinterpret_array_view(uint8_av); EXPECT_EQ(int8_av.size(), uint8_av.size()); EXPECT_EQ(int8_av[0], 1); EXPECT_EQ(int8_av[1], 2); EXPECT_EQ(int8_av[2], 3); } TEST(ArrayViewTest, TestReinterpretCastVariableSize) { std::vector v = {1, 2, 3}; ArrayView int8_av(v); ArrayView uint8_av = reinterpret_array_view(int8_av); EXPECT_EQ(int8_av.size(), uint8_av.size()); EXPECT_EQ(uint8_av[0], 1); EXPECT_EQ(uint8_av[1], 2); EXPECT_EQ(uint8_av[2], 3); } } // namespace rtc