/* * 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. */ #ifndef NETUTILS_STATUSOR_H #define NETUTILS_STATUSOR_H #include <cassert> #include "netdutils/Status.h" namespace android { namespace netdutils { // Wrapper around a combination of Status and application value type. // T may be any copyable or movable type. template <typename T> class StatusOr { public: StatusOr() = default; StatusOr(const Status status) : mStatus(status) { assert(!isOk(status)); } StatusOr(const T& value) : mStatus(status::ok), mValue(value) {} StatusOr(T&& value) : mStatus(status::ok), mValue(std::move(value)) {} // Move constructor ok (if T supports move) StatusOr(StatusOr&&) = default; // Move assignment ok (if T supports move) StatusOr& operator=(StatusOr&&) = default; // Copy constructor ok (if T supports copy) StatusOr(const StatusOr&) = default; // Copy assignment ok (if T supports copy) StatusOr& operator=(const StatusOr&) = default; // Return const references to wrapped type // It is an error to call value() when !isOk(status()) const T& value() const & { return mValue; } const T&& value() const && { return mValue; } // Return rvalue references to wrapped type // It is an error to call value() when !isOk(status()) T& value() & { return mValue; } T&& value() && { return mValue; } // Return status assigned in constructor const Status status() const { return mStatus; } // Implict cast to Status operator Status() const { return status(); } private: Status mStatus = status::undefined; T mValue; }; template <typename T> inline std::ostream& operator<<(std::ostream& os, const StatusOr<T>& s) { return os << "StatusOr[status: " << s.status() << "]"; } #define ASSIGN_OR_RETURN_IMPL(tmp, lhs, stmt) \ auto tmp = (stmt); \ RETURN_IF_NOT_OK(tmp); \ lhs = std::move(tmp.value()); #define ASSIGN_OR_RETURN_CONCAT(line, lhs, stmt) \ ASSIGN_OR_RETURN_IMPL(__CONCAT(_status_or_, line), lhs, stmt) // Macro to allow exception-like handling of error return values. // // If the evaluation of stmt results in an error, return that error // from the current function. Otherwise, assign the result to lhs. // // This macro supports both move and copy assignment operators. lhs // may be either a new local variable or an existing non-const // variable accessible in the current scope. // // Example usage: // StatusOr<MyType> foo() { ... } // // ASSIGN_OR_RETURN(auto myVar, foo()); // ASSIGN_OR_RETURN(myExistingVar, foo()); // ASSIGN_OR_RETURN(myMemberVar, foo()); #define ASSIGN_OR_RETURN(lhs, stmt) ASSIGN_OR_RETURN_CONCAT(__LINE__, lhs, stmt) } // namespace netdutils } // namespace android #endif /* NETUTILS_STATUSOR_H */