status.h

// Copyright 2014 Google Inc. All rights reserved.
//
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file or at
// https://developers.google.com/open-source/licenses/bsd
 
#ifndef PACKAGER_STATUS_H_
#define PACKAGER_STATUS_H_
 
#include <iostream>
#include <string>
 
#if defined(SHARED_LIBRARY_BUILD)
#if defined(_WIN32)
 
#if defined(SHAKA_IMPLEMENTATION)
#define SHAKA_EXPORT __declspec(dllexport)
#else
#define SHAKA_EXPORT __declspec(dllimport)
#endif  // defined(SHAKA_IMPLEMENTATION)
 
#else  // defined(_WIN32)
 
#if defined(SHAKA_IMPLEMENTATION)
#define SHAKA_EXPORT __attribute__((visibility("default")))
#else
#define SHAKA_EXPORT
#endif
 
#endif  // defined(_WIN32)
 
#else  // defined(SHARED_LIBRARY_BUILD)
#define SHAKA_EXPORT
#endif  // defined(SHARED_LIBRARY_BUILD)
 
namespace shaka {
 
namespace error {
 
enum Code {
  // Not an error; returned on success
  OK,
 
  // Unknown error.  An example of where this error may be returned is
  // errors raised by APIs that do not return enough error information
  // may be converted to this error.
  UNKNOWN,
 
  // The operation was cancelled (typically by the caller).
  CANCELLED,
 
  // Client specified an invalid argument. INVALID_ARGUMENT indicates
  // arguments that are problematic regardless of the state of the system
  // (e.g. a malformed file name).
  INVALID_ARGUMENT,
 
  // Operation is not implemented or not supported/enabled.
  UNIMPLEMENTED,
 
  // Cannot open file.
  FILE_FAILURE,
 
  // End of stream.
  END_OF_STREAM,
 
  // Failure to get HTTP response successfully,
  HTTP_FAILURE,
 
  // Unable to parse the media file.
  PARSER_FAILURE,
 
  // Failed to do the encryption.
  ENCRYPTION_FAILURE,
 
  // Error when trying to do chunking.
  CHUNKING_ERROR,
 
  // Fail to mux the media file.
  MUXER_FAILURE,
 
  // This track fragment is finalized.
  FRAGMENT_FINALIZED,
 
  // Server errors. Receives malformed response from server.
  SERVER_ERROR,
 
  // Internal errors. Some invariants have been broken.
  INTERNAL_ERROR,
 
  // The operation was stopped.
  STOPPED,
 
  // The operation timed out.
  TIME_OUT,
 
  // Value was not found.
  NOT_FOUND,
 
  // The entity that a client attempted to create (e.g., file or directory)
  // already exists.
  ALREADY_EXISTS,
 
  // Error when trying to generate trick play stream.
  TRICK_PLAY_ERROR,
};
 
}  // namespace error
 
class SHAKA_EXPORT Status {
 public:
  Status() : error_code_(error::OK) {}
 
  Status(error::Code error_code, const std::string& error_message);
 
  static const Status OK;  // Identical to 0-arg constructor.
  static const Status UNKNOWN;
 
  void Update(Status new_status);
 
  bool ok() const { return error_code_ == error::OK; }
  error::Code error_code() const { return error_code_; }
  const std::string& error_message() const { return error_message_; }
 
  bool operator==(const Status& x) const {
    return error_code_ == x.error_code() && error_message_ == x.error_message();
  }
  bool operator!=(const Status& x) const { return !(*this == x); }
 
  std::string ToString() const;
 
 private:
  error::Code error_code_;
  std::string error_message_;
 
  // Not using DISALLOW_COPY_AND_ASSIGN here intentionally to allow the compiler
  // generated copy constructor and assignment operator.
};
 
SHAKA_EXPORT std::ostream& operator<<(std::ostream& os, const Status& x);
 
}  // namespace shaka
 
#endif  // PACKAGER_STATUS_H_