/* * Copyright (C) 2017 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "result.h" #include "errno.h" #include #include using namespace std::string_literals; namespace android { namespace init { TEST(result, result_accessors) { Result result = "success"; ASSERT_TRUE(result); ASSERT_TRUE(result.has_value()); EXPECT_EQ("success", *result); EXPECT_EQ("success", result.value()); EXPECT_EQ('s', result->data()[0]); } TEST(result, result_accessors_rvalue) { ASSERT_TRUE(Result("success")); ASSERT_TRUE(Result("success").has_value()); EXPECT_EQ("success", *Result("success")); EXPECT_EQ("success", Result("success").value()); EXPECT_EQ('s', Result("success")->data()[0]); } TEST(result, result_success) { Result result = Success(); ASSERT_TRUE(result); ASSERT_TRUE(result.has_value()); EXPECT_EQ(Success(), *result); EXPECT_EQ(Success(), result.value()); } TEST(result, result_success_rvalue) { // Success() doesn't actually create a Result object, but rather an object that can be // implicitly constructed into a Result object. auto MakeRvalueSuccessResult = []() -> Result { return Success(); }; ASSERT_TRUE(MakeRvalueSuccessResult()); ASSERT_TRUE(MakeRvalueSuccessResult().has_value()); EXPECT_EQ(Success(), *MakeRvalueSuccessResult()); EXPECT_EQ(Success(), MakeRvalueSuccessResult().value()); } TEST(result, result_error) { Result result = Error() << "failure" << 1; ASSERT_FALSE(result); ASSERT_FALSE(result.has_value()); EXPECT_EQ(0, result.error_errno()); EXPECT_EQ("failure1", result.error_string()); } TEST(result, result_error_empty) { Result result = Error(); ASSERT_FALSE(result); ASSERT_FALSE(result.has_value()); EXPECT_EQ(0, result.error_errno()); EXPECT_EQ("", result.error_string()); } TEST(result, result_error_rvalue) { // Error() and ErrnoError() aren't actually used to create a Result object. // Under the hood, they are an intermediate class that can be implicitly constructed into a // Result. This is needed both to create the ostream and because Error() itself, by // definition will not know what the type, T, of the underlying Result object that it would // create is. auto MakeRvalueErrorResult = []() -> Result { return Error() << "failure" << 1; }; ASSERT_FALSE(MakeRvalueErrorResult()); ASSERT_FALSE(MakeRvalueErrorResult().has_value()); EXPECT_EQ(0, MakeRvalueErrorResult().error_errno()); EXPECT_EQ("failure1", MakeRvalueErrorResult().error_string()); } TEST(result, result_errno_error) { constexpr int test_errno = 6; errno = test_errno; Result result = ErrnoError() << "failure" << 1; ASSERT_FALSE(result); ASSERT_FALSE(result.has_value()); EXPECT_EQ(test_errno, result.error_errno()); EXPECT_EQ("failure1: "s + strerror(test_errno), result.error_string()); } TEST(result, result_errno_error_no_text) { constexpr int test_errno = 6; errno = test_errno; Result result = ErrnoError(); ASSERT_FALSE(result); ASSERT_FALSE(result.has_value()); EXPECT_EQ(test_errno, result.error_errno()); EXPECT_EQ(strerror(test_errno), result.error_string()); } TEST(result, result_error_from_other_result) { auto error_text = "test error"s; Result result = Error() << error_text; ASSERT_FALSE(result); ASSERT_FALSE(result.has_value()); Result result2 = result.error(); ASSERT_FALSE(result2); ASSERT_FALSE(result2.has_value()); EXPECT_EQ(0, result.error_errno()); EXPECT_EQ(error_text, result.error_string()); } TEST(result, result_error_through_ostream) { auto error_text = "test error"s; Result result = Error() << error_text; ASSERT_FALSE(result); ASSERT_FALSE(result.has_value()); Result result2 = Error() << result.error(); ASSERT_FALSE(result2); ASSERT_FALSE(result2.has_value()); EXPECT_EQ(0, result.error_errno()); EXPECT_EQ(error_text, result.error_string()); } TEST(result, result_errno_error_through_ostream) { auto error_text = "test error"s; constexpr int test_errno = 6; errno = 6; Result result = ErrnoError() << error_text; errno = 0; ASSERT_FALSE(result); ASSERT_FALSE(result.has_value()); Result result2 = Error() << result.error(); ASSERT_FALSE(result2); ASSERT_FALSE(result2.has_value()); EXPECT_EQ(test_errno, result.error_errno()); EXPECT_EQ(error_text + ": " + strerror(test_errno), result.error_string()); } TEST(result, constructor_forwarding) { auto result = Result(5, 'a'); ASSERT_TRUE(result); ASSERT_TRUE(result.has_value()); EXPECT_EQ("aaaaa", *result); } struct ConstructorTracker { static size_t constructor_called; static size_t copy_constructor_called; static size_t move_constructor_called; static size_t copy_assignment_called; static size_t move_assignment_called; template ConstructorTracker(T&& string) : string(string) { ++constructor_called; } ConstructorTracker(const ConstructorTracker& ct) { ++copy_constructor_called; string = ct.string; } ConstructorTracker(ConstructorTracker&& ct) noexcept { ++move_constructor_called; string = std::move(ct.string); } ConstructorTracker& operator=(const ConstructorTracker& ct) { ++copy_assignment_called; string = ct.string; return *this; } ConstructorTracker& operator=(ConstructorTracker&& ct) noexcept { ++move_assignment_called; string = std::move(ct.string); return *this; } std::string string; }; size_t ConstructorTracker::constructor_called = 0; size_t ConstructorTracker::copy_constructor_called = 0; size_t ConstructorTracker::move_constructor_called = 0; size_t ConstructorTracker::copy_assignment_called = 0; size_t ConstructorTracker::move_assignment_called = 0; Result ReturnConstructorTracker(const std::string& in) { if (in.empty()) { return "literal string"; } if (in == "test2") { return ConstructorTracker(in + in + "2"); } ConstructorTracker result(in + " " + in); return result; }; TEST(result, no_copy_on_return) { // If returning parameters that may be used to implicitly construct the type T of Result, // then those parameters are forwarded to the construction of Result. // If returning an prvalue or xvalue, it will be move constructed during the construction of // Result. // This check ensures that that is the case, and particularly that no copy constructors // are called. auto result1 = ReturnConstructorTracker(""); ASSERT_TRUE(result1); EXPECT_EQ("literal string", result1->string); EXPECT_EQ(1U, ConstructorTracker::constructor_called); EXPECT_EQ(0U, ConstructorTracker::copy_constructor_called); EXPECT_EQ(0U, ConstructorTracker::move_constructor_called); EXPECT_EQ(0U, ConstructorTracker::copy_assignment_called); EXPECT_EQ(0U, ConstructorTracker::move_assignment_called); auto result2 = ReturnConstructorTracker("test2"); ASSERT_TRUE(result2); EXPECT_EQ("test2test22", result2->string); EXPECT_EQ(2U, ConstructorTracker::constructor_called); EXPECT_EQ(0U, ConstructorTracker::copy_constructor_called); EXPECT_EQ(1U, ConstructorTracker::move_constructor_called); EXPECT_EQ(0U, ConstructorTracker::copy_assignment_called); EXPECT_EQ(0U, ConstructorTracker::move_assignment_called); auto result3 = ReturnConstructorTracker("test3"); ASSERT_TRUE(result3); EXPECT_EQ("test3 test3", result3->string); EXPECT_EQ(3U, ConstructorTracker::constructor_called); EXPECT_EQ(0U, ConstructorTracker::copy_constructor_called); EXPECT_EQ(2U, ConstructorTracker::move_constructor_called); EXPECT_EQ(0U, ConstructorTracker::copy_assignment_called); EXPECT_EQ(0U, ConstructorTracker::move_assignment_called); } // Below two tests require that we do not hide the move constructor with our forwarding reference // constructor. This is done with by disabling the forwarding reference constructor if its first // and only type is Result. TEST(result, result_result_with_success) { auto return_result_result_with_success = []() -> Result> { return Result(); }; auto result = return_result_result_with_success(); ASSERT_TRUE(result); ASSERT_TRUE(*result); auto inner_result = result.value(); ASSERT_TRUE(inner_result); } TEST(result, result_result_with_failure) { auto return_result_result_with_error = []() -> Result> { return Result(ResultError("failure string", 6)); }; auto result = return_result_result_with_error(); ASSERT_TRUE(result); ASSERT_FALSE(*result); EXPECT_EQ("failure string", result->error_string()); EXPECT_EQ(6, result->error_errno()); } // This test requires that we disable the forwarding reference constructor if Result is the // *only* type that we are forwarding. In otherwords, if we are forwarding Result, int to // construct a Result, then we still need the constructor. TEST(result, result_two_parameter_constructor_same_type) { struct TestStruct { TestStruct(int value) : value_(value) {} TestStruct(Result result, int value) : value_(result->value_ * value) {} int value_; }; auto return_test_struct = []() -> Result { return {Result(6), 6}; }; auto result = return_test_struct(); ASSERT_TRUE(result); EXPECT_EQ(36, result->value_); } TEST(result, die_on_access_failed_result) { Result result = Error(); ASSERT_DEATH(*result, ""); } TEST(result, die_on_get_error_succesful_result) { Result result = "success"; ASSERT_DEATH(result.error_string(), ""); } } // namespace init } // namespace android