// This file is part of the Luau programming language and is licensed under MIT License; see LICENSE.txt for details #include "Luau/VecDeque.h" #include "doctest.h" #include TEST_SUITE_BEGIN("VecDequeTests"); TEST_CASE("forward_queue_test_no_initial_capacity") { // initial capacity is not set, so this should grow to be 11 Luau::VecDeque queue{}; REQUIRE(queue.empty()); for (int i = 0; i < 10; i++) queue.push_back(i); // q: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 REQUIRE(!queue.empty()); REQUIRE(queue.size() == 10); CHECK_EQ(queue.capacity(), 11); for (int j = 0; j < 10; j++) { CHECK_EQ(queue.front(), j); CHECK_EQ(queue.back(), 9); REQUIRE(!queue.empty()); queue.pop_front(); } } TEST_CASE("forward_queue_test") { // initial capacity set to 5 so that a grow is necessary Luau::VecDeque queue; queue.reserve(5); REQUIRE(queue.empty()); for (int i = 0; i < 10; i++) queue.push_back(i); // q: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 REQUIRE(!queue.empty()); REQUIRE(queue.size() == 10); CHECK_EQ(queue.capacity(), 13); for (int j = 0; j < 10; j++) { CHECK_EQ(queue.front(), j); CHECK_EQ(queue.back(), 9); REQUIRE(!queue.empty()); queue.pop_front(); } } TEST_CASE("forward_queue_test_initializer_list") { Luau::VecDeque queue{0, 1, 2, 3, 4, 5, 6, 7, 8, 9}; // q: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 REQUIRE(!queue.empty()); REQUIRE(queue.size() == 10); CHECK_EQ(queue.capacity(), 10); for (int j = 0; j < 10; j++) { CHECK_EQ(queue.front(), j); CHECK_EQ(queue.back(), 9); REQUIRE(!queue.empty()); queue.pop_front(); } } TEST_CASE("reverse_queue_test") { // initial capacity set to 5 so that a grow is necessary Luau::VecDeque queue; queue.reserve(5); REQUIRE(queue.empty()); for (int i = 0; i < 10; i++) queue.push_front(i); // q: 9, 8, 7, 6, 5, 4, 3, 2, 1, 0 REQUIRE(!queue.empty()); REQUIRE(queue.size() == 10); CHECK_EQ(queue.capacity(), 13); for (int j = 0; j < 10; j++) { CHECK_EQ(queue.front(), 9); CHECK_EQ(queue.back(), j); REQUIRE(!queue.empty()); queue.pop_back(); } } TEST_CASE("random_access_queue_test") { // initial capacity set to 5 so that a grow is necessary Luau::VecDeque queue; queue.reserve(5); REQUIRE(queue.empty()); for (int i = 0; i < 10; i++) queue.push_back(i); // q: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 REQUIRE(!queue.empty()); REQUIRE(queue.size() == 10); for (int j = 0; j < 10; j++) { CHECK_EQ(queue.at(j), j); CHECK_EQ(queue[j], j); } } TEST_CASE("clear_works_on_queue") { // initial capacity set to 5 so that a grow is necessary Luau::VecDeque queue; queue.reserve(5); REQUIRE(queue.empty()); for (int i = 0; i < 10; i++) queue.push_back(i); // q: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 REQUIRE(!queue.empty()); REQUIRE(queue.size() == 10); for (int j = 0; j < 10; j++) CHECK_EQ(queue[j], j); queue.clear(); CHECK(queue.empty()); CHECK(queue.size() == 0); } TEST_CASE("pop_front_at_end") { // initial capacity set to 5 so that a grow is necessary Luau::VecDeque queue; queue.reserve(5); REQUIRE(queue.empty()); // setting up the internal buffer to be: 1234567890 by the end (i.e. 0 at the end of the buffer) queue.push_front(0); for (int i = 1; i < 10; i++) queue.push_back(i); // q: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 REQUIRE(!queue.empty()); REQUIRE(queue.size() == 10); for (int j = 0; j < 10; j++) { CHECK_EQ(queue.front(), j); CHECK_EQ(queue.back(), 9); REQUIRE(!queue.empty()); queue.pop_front(); } } TEST_CASE("pop_back_at_front") { // initial capacity set to 5 so that a grow is necessary Luau::VecDeque queue; queue.reserve(5); REQUIRE(queue.empty()); // setting up the internal buffer to be: 9012345678 by the end (i.e. 9 at the front of the buffer) queue.push_back(0); for (int i = 1; i < 10; i++) queue.push_front(i); // q: 9, 8, 7, 6, 5, 4, 3, 2, 1, 0 REQUIRE(!queue.empty()); REQUIRE(queue.size() == 10); for (int j = 0; j < 10; j++) { CHECK_EQ(queue.front(), 9); CHECK_EQ(queue.back(), j); REQUIRE(!queue.empty()); queue.pop_back(); } } TEST_CASE("queue_is_contiguous") { // initial capacity is not set, so this should grow to be 11 Luau::VecDeque queue{}; REQUIRE(queue.empty()); for (int i = 0; i < 10; i++) queue.push_back(i); // q: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 REQUIRE(!queue.empty()); REQUIRE(queue.size() == 10); CHECK_EQ(queue.capacity(), 11); CHECK(queue.is_contiguous()); } TEST_CASE("queue_is_not_contiguous") { // initial capacity is not set, so this should grow to be 11 Luau::VecDeque queue{}; REQUIRE(queue.empty()); for (int i = 5; i < 10; i++) queue.push_back(i); for (int i = 4; i >= 0; i--) queue.push_front(i); // buffer: 56789......01234 // q: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 REQUIRE(!queue.empty()); REQUIRE(queue.size() == 10); CHECK_EQ(queue.capacity(), 11); CHECK(!queue.is_contiguous()); // checking that it is indeed sequential integers from 0 to 9 for (int j = 0; j < 10; j++) CHECK_EQ(queue[j], j); } TEST_CASE("shrink_to_fit_works") { // initial capacity is not set, so this should grow to be 11 Luau::VecDeque queue{}; REQUIRE(queue.empty()); for (int i = 5; i < 10; i++) queue.push_back(i); for (int i = 4; i >= 0; i--) queue.push_front(i); // buffer: 56789......01234 // q: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 REQUIRE(!queue.empty()); REQUIRE(queue.size() == 10); REQUIRE_EQ(queue.capacity(), 11); CHECK(!queue.is_contiguous()); // checking that it is indeed sequential integers from 0 to 9 for (int j = 0; j < 10; j++) CHECK_EQ(queue[j], j); queue.shrink_to_fit(); // shrink to fit always makes a contiguous buffer CHECK(queue.is_contiguous()); // the capacity should be exactly the size now CHECK_EQ(queue.capacity(), queue.size()); REQUIRE(!queue.empty()); // checking that it is still sequential integers from 0 to 9 for (int j = 0; j < 10; j++) CHECK_EQ(queue[j], j); } const static std::string testStringSet[2][10] = { // To hit potential SSO issues showing memory management issues, we need small strings {"one", "two", "three", "four", "five", "six", "seven", "eight", "nine", "ten"}, // This list of non-SSO test strings consists of quotes from Ursula K. Le Guin. {"Love doesn't just sit there, like a stone, it has to be made, like bread; remade all the time, made new.", "People who deny the existence of dragons are often eaten by dragons. From within.", "It is good to have an end to journey toward; but it is the journey that matters, in the end.", "We're each of us alone, to be sure. What can you do but hold your hand out in the dark?", "When you light a candle, you also cast a shadow.", "You cannot buy the revolution. You cannot make the revolution. You can only be the revolution. It is in your spirit, or it is nowhere.", "To learn which questions are unanswerable, and not to answer them: this skill is most needful in times of stress and darkness.", "What sane person could live in this world and not be crazy?", "The only thing that makes life possible is permanent, intolerable uncertainty: not knowing what comes next.", "My imagination makes me human and makes me a fool; it gives me all the world and exiles me from it."}}; TEST_CASE("string_queue_test_no_initial_capacity") { for (size_t stringSet = 0; stringSet < 2; stringSet++) { auto testStrings = testStringSet[stringSet]; // initial capacity is not set, so this should grow to be 11 Luau::VecDeque queue; REQUIRE(queue.empty()); for (int i = 0; i < 10; i++) queue.push_back(testStrings[i]); // q: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 REQUIRE(!queue.empty()); REQUIRE(queue.size() == 10); CHECK_EQ(queue.capacity(), 11); for (int j = 0; j < 10; j++) { CHECK_EQ(queue.front(), testStrings[j]); CHECK_EQ(queue.back(), testStrings[9]); REQUIRE(!queue.empty()); queue.pop_front(); } } } TEST_CASE("string_queue_test") { for (size_t stringSet = 0; stringSet < 2; stringSet++) { auto testStrings = testStringSet[stringSet]; // initial capacity set to 5 so that a grow is necessary Luau::VecDeque queue; queue.reserve(5); REQUIRE(queue.empty()); for (int i = 0; i < 10; i++) queue.push_back(testStrings[i]); // q: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 REQUIRE(!queue.empty()); REQUIRE(queue.size() == 10); CHECK_EQ(queue.capacity(), 13); for (int j = 0; j < 10; j++) { CHECK_EQ(queue.front(), testStrings[j]); CHECK_EQ(queue.back(), testStrings[9]); REQUIRE(!queue.empty()); queue.pop_front(); } } } TEST_CASE("string_queue_test_initializer_list") { for (size_t stringSet = 0; stringSet < 2; stringSet++) { auto testStrings = testStringSet[stringSet]; Luau::VecDeque queue{ testStrings[0], testStrings[1], testStrings[2], testStrings[3], testStrings[4], testStrings[5], testStrings[6], testStrings[7], testStrings[8], testStrings[9], }; // q: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 REQUIRE(!queue.empty()); REQUIRE(queue.size() == 10); CHECK_EQ(queue.capacity(), 10); for (int j = 0; j < 10; j++) { CHECK_EQ(queue.front(), testStrings[j]); CHECK_EQ(queue.back(), testStrings[9]); REQUIRE(!queue.empty()); queue.pop_front(); } } } TEST_CASE("reverse_string_queue_test") { for (size_t stringSet = 0; stringSet < 2; stringSet++) { auto testStrings = testStringSet[stringSet]; // initial capacity set to 5 so that a grow is necessary Luau::VecDeque queue; queue.reserve(5); REQUIRE(queue.empty()); for (int i = 0; i < 10; i++) queue.push_front(testStrings[i]); // q: 9, 8, 7, 6, 5, 4, 3, 2, 1, 0 REQUIRE(!queue.empty()); REQUIRE(queue.size() == 10); CHECK_EQ(queue.capacity(), 13); for (int j = 0; j < 10; j++) { CHECK_EQ(queue.front(), testStrings[9]); CHECK_EQ(queue.back(), testStrings[j]); REQUIRE(!queue.empty()); queue.pop_back(); } } } TEST_CASE("random_access_string_queue_test") { for (size_t stringSet = 0; stringSet < 2; stringSet++) { auto testStrings = testStringSet[stringSet]; // initial capacity set to 5 so that a grow is necessary Luau::VecDeque queue; queue.reserve(5); REQUIRE(queue.empty()); for (int i = 0; i < 10; i++) queue.push_back(testStrings[i]); // q: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 REQUIRE(!queue.empty()); REQUIRE(queue.size() == 10); for (int j = 0; j < 10; j++) { CHECK_EQ(queue.at(j), testStrings[j]); CHECK_EQ(queue[j], testStrings[j]); } } } TEST_CASE("clear_works_on_string_queue") { for (size_t stringSet = 0; stringSet < 2; stringSet++) { auto testStrings = testStringSet[stringSet]; // initial capacity set to 5 so that a grow is necessary Luau::VecDeque queue; queue.reserve(5); REQUIRE(queue.empty()); for (int i = 0; i < 10; i++) queue.push_back(testStrings[i]); // q: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 REQUIRE(!queue.empty()); REQUIRE(queue.size() == 10); for (int j = 0; j < 10; j++) CHECK_EQ(queue[j], testStrings[j]); queue.clear(); CHECK(queue.empty()); CHECK(queue.size() == 0); } } TEST_CASE("pop_front_string_at_end") { for (size_t stringSet = 0; stringSet < 2; stringSet++) { auto testStrings = testStringSet[stringSet]; // initial capacity set to 5 so that a grow is necessary Luau::VecDeque queue; queue.reserve(5); REQUIRE(queue.empty()); // setting up the internal buffer to be: 1234567890 by the end (i.e. 0 at the end of the buffer) queue.push_front(testStrings[0]); for (int i = 1; i < 10; i++) queue.push_back(testStrings[i]); // q: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 REQUIRE(!queue.empty()); REQUIRE(queue.size() == 10); for (int j = 0; j < 10; j++) { CHECK_EQ(queue.front(), testStrings[j]); CHECK_EQ(queue.back(), testStrings[9]); REQUIRE(!queue.empty()); queue.pop_front(); } } } TEST_CASE("pop_back_string_at_front") { for (size_t stringSet = 0; stringSet < 2; stringSet++) { auto testStrings = testStringSet[stringSet]; // initial capacity set to 5 so that a grow is necessary Luau::VecDeque queue; queue.reserve(5); REQUIRE(queue.empty()); // setting up the internal buffer to be: 9012345678 by the end (i.e. 9 at the front of the buffer) queue.push_back(testStrings[0]); for (int i = 1; i < 10; i++) queue.push_front(testStrings[i]); // q: 9, 8, 7, 6, 5, 4, 3, 2, 1, 0 REQUIRE(!queue.empty()); REQUIRE(queue.size() == 10); for (int j = 0; j < 10; j++) { CHECK_EQ(queue.front(), testStrings[9]); CHECK_EQ(queue.back(), testStrings[j]); REQUIRE(!queue.empty()); queue.pop_back(); } } } TEST_CASE("string_queue_is_contiguous") { for (size_t stringSet = 0; stringSet < 2; stringSet++) { auto testStrings = testStringSet[stringSet]; // initial capacity is not set, so this should grow to be 11 Luau::VecDeque queue{}; REQUIRE(queue.empty()); for (int i = 0; i < 10; i++) queue.push_back(testStrings[i]); // q: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 REQUIRE(!queue.empty()); REQUIRE(queue.size() == 10); CHECK_EQ(queue.capacity(), 11); CHECK(queue.is_contiguous()); for (int j = 0; j < 10; j++) CHECK_EQ(queue[j], testStrings[j]); // Check copy construction Luau::VecDeque queue2 = queue; REQUIRE(!queue2.empty()); REQUIRE(queue2.size() == 10); CHECK_EQ(queue2.capacity(), 11); CHECK(queue2.is_contiguous()); for (int j = 0; j < 10; j++) CHECK_EQ(queue2[j], testStrings[j]); // Check copy assignment Luau::VecDeque queue3; queue3 = queue; REQUIRE(!queue3.empty()); REQUIRE(queue3.size() == 10); CHECK_EQ(queue3.capacity(), 11); CHECK(queue3.is_contiguous()); for (int j = 0; j < 10; j++) CHECK_EQ(queue3[j], testStrings[j]); // Check move construction Luau::VecDeque queue4 = std::move(queue3); REQUIRE(!queue4.empty()); REQUIRE(queue4.size() == 10); CHECK_EQ(queue4.capacity(), 11); CHECK(queue4.is_contiguous()); for (int j = 0; j < 10; j++) CHECK_EQ(queue4[j], testStrings[j]); // Check move assignment Luau::VecDeque queue5; queue5 = std::move(queue2); REQUIRE(!queue5.empty()); REQUIRE(queue5.size() == 10); CHECK_EQ(queue5.capacity(), 11); CHECK(queue5.is_contiguous()); for (int j = 0; j < 10; j++) CHECK_EQ(queue5[j], testStrings[j]); } } TEST_CASE("string_queue_is_not_contiguous") { for (size_t stringSet = 0; stringSet < 2; stringSet++) { auto testStrings = testStringSet[stringSet]; // initial capacity is not set, so this should grow to be 11 Luau::VecDeque queue{}; REQUIRE(queue.empty()); for (int i = 5; i < 10; i++) queue.push_back(testStrings[i]); for (int i = 4; i >= 0; i--) queue.push_front(testStrings[i]); // buffer: 56789......01234 // q: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 REQUIRE(!queue.empty()); REQUIRE(queue.size() == 10); CHECK_EQ(queue.capacity(), 11); CHECK(!queue.is_contiguous()); // checking that it is indeed sequential integers from 0 to 9 for (int j = 0; j < 10; j++) CHECK_EQ(queue[j], testStrings[j]); // Check copy construction Luau::VecDeque queue2 = queue; REQUIRE(!queue2.empty()); REQUIRE(queue2.size() == 10); CHECK_EQ(queue2.capacity(), 11); CHECK(!queue2.is_contiguous()); for (int j = 0; j < 10; j++) CHECK_EQ(queue2[j], testStrings[j]); // Check copy assignment Luau::VecDeque queue3; queue3 = queue; REQUIRE(!queue3.empty()); REQUIRE(queue3.size() == 10); CHECK_EQ(queue3.capacity(), 11); CHECK(queue3.is_contiguous()); for (int j = 0; j < 10; j++) CHECK_EQ(queue3[j], testStrings[j]); // Check move construction Luau::VecDeque queue4 = std::move(queue); REQUIRE(!queue4.empty()); REQUIRE(queue4.size() == 10); CHECK_EQ(queue4.capacity(), 11); CHECK(!queue4.is_contiguous()); for (int j = 0; j < 10; j++) CHECK_EQ(queue4[j], testStrings[j]); // Check move assignment Luau::VecDeque queue5; queue5 = std::move(queue2); REQUIRE(!queue5.empty()); REQUIRE(queue5.size() == 10); CHECK_EQ(queue5.capacity(), 11); CHECK(!queue5.is_contiguous()); for (int j = 0; j < 10; j++) CHECK_EQ(queue5[j], testStrings[j]); // Check that grow from discontiguous is handled well queue4.push_back("zero"); queue4.push_back("?"); for (int j = 0; j < 10; j++) CHECK_EQ(queue4[j], testStrings[j]); CHECK_EQ(queue4[10], "zero"); CHECK_EQ(queue4[11], "?"); // Check that reserve from discontiguous is handled well queue5.reserve(20); for (int j = 0; j < 10; j++) CHECK_EQ(queue5[j], testStrings[j]); } } TEST_CASE("shrink_to_fit_works_with_strings") { for (size_t stringSet = 0; stringSet < 2; stringSet++) { auto testStrings = testStringSet[stringSet]; // initial capacity is not set, so this should grow to be 11 Luau::VecDeque queue{}; REQUIRE(queue.empty()); for (int i = 5; i < 10; i++) queue.push_back(testStrings[i]); for (int i = 4; i >= 0; i--) queue.push_front(testStrings[i]); // buffer: 56789......01234 // q: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 REQUIRE(!queue.empty()); REQUIRE(queue.size() == 10); REQUIRE_EQ(queue.capacity(), 11); CHECK(!queue.is_contiguous()); // checking that it is indeed sequential integers from 0 to 9 for (int j = 0; j < 10; j++) CHECK_EQ(queue[j], testStrings[j]); queue.shrink_to_fit(); // shrink to fit always makes a contiguous buffer CHECK(queue.is_contiguous()); // the capacity should be exactly the size now CHECK_EQ(queue.capacity(), queue.size()); REQUIRE(!queue.empty()); // checking that it is still sequential integers from 0 to 9 for (int j = 0; j < 10; j++) CHECK_EQ(queue[j], testStrings[j]); } } struct TestStruct { }; // Verify that elements pushed to the front of the queue are properly destroyed when the queue is destroyed. TEST_CASE("push_front_elements_are_destroyed_correctly") { std::shared_ptr t = std::make_shared(); { Luau::VecDeque> queue{}; REQUIRE(queue.empty()); queue.reserve(10); queue.push_front(t); queue.push_front(t); REQUIRE(t.use_count() == 3); // Num of references to the TestStruct instance is now 3 // <-- call destructor here // Extra check for correct copies Luau::VecDeque> queue2 = queue; Luau::VecDeque> queue3; queue3 = queue; } // At this point the destructor should be called and we should be back down to one instance of TestStruct REQUIRE(t.use_count() == 1); } TEST_SUITE_END();