status.h

/*    Copyright 2012 10gen Inc.
 *
 *    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.
 */
 
#pragma once
 
#include <iosfwd>
#include <string>
 
#include "mongo/base/error_codes.h"
#include "mongo/client/export_macros.h"
#include "mongo/platform/atomic_word.h"
 
namespace mongo {
 
class MONGO_CLIENT_API Status {
public:
    // Short-hand for returning an OK status.
    static inline Status MONGO_CLIENT_FUNC OK();
 
    Status(ErrorCodes::Error code, const std::string& reason, int location = 0);
    Status(ErrorCodes::Error code, const char* reason, int location = 0);
 
    inline Status(const Status& other);
    inline Status& operator=(const Status& other);
 
#if __cplusplus >= 201103L
    inline Status(Status&& other) noexcept;
    inline Status& operator=(Status&& other) noexcept;
#endif  // __cplusplus >= 201103L
 
    inline ~Status();
 
    bool compare(const Status& other) const;
    bool operator==(const Status& other) const;
    bool operator!=(const Status& other) const;
 
    bool compareCode(const ErrorCodes::Error other) const;
    bool operator==(const ErrorCodes::Error other) const;
    bool operator!=(const ErrorCodes::Error other) const;
 
    //
    // accessors
    //
 
    inline bool isOK() const;
 
    inline ErrorCodes::Error code() const;
 
    inline std::string codeString() const;
 
    inline std::string reason() const;
 
    inline int location() const;
 
    std::string toString() const;
 
    //
    // Below interface used for testing code only.
    //
 
    inline AtomicUInt32::WordType refCount() const;
 
private:
    inline Status();
 
    struct ErrorInfo {
        AtomicUInt32 refs;             // reference counter
        const ErrorCodes::Error code;  // error code
        const std::string reason;      // description of error cause
        const int location;            // unique location of the triggering line in the code
 
        static ErrorInfo* create(ErrorCodes::Error code, const StringData& reason, int location);
 
        ErrorInfo(ErrorCodes::Error code, const StringData& reason, int location);
    };
 
    ErrorInfo* _error;
 
    static inline void MONGO_CLIENT_FUNC ref(ErrorInfo* error);
    static inline void MONGO_CLIENT_FUNC unref(ErrorInfo* error);
};
 
MONGO_CLIENT_API inline bool MONGO_CLIENT_FUNC
operator==(const ErrorCodes::Error lhs, const Status& rhs);
 
MONGO_CLIENT_API inline bool MONGO_CLIENT_FUNC
operator!=(const ErrorCodes::Error lhs, const Status& rhs);
 
//
// Convenience method for unittest code. Please use accessors otherwise.
//
 
MONGO_CLIENT_API std::ostream& MONGO_CLIENT_FUNC operator<<(std::ostream& os, const Status& status);
MONGO_CLIENT_API std::ostream& MONGO_CLIENT_FUNC operator<<(std::ostream& os, ErrorCodes::Error);
 
}  // namespace mongo
 
#include "mongo/base/status-inl.h"