/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

#ifndef STREAM_H_
#define STREAM_H_

#include "DecoderDoctorLogger.h"
#include "nsISupportsImpl.h"

namespace mozilla {

DDLoggedTypeDeclName(ByteStream);

class ByteStream : public DecoderDoctorLifeLogger<ByteStream> {
 public:
  NS_INLINE_DECL_THREADSAFE_REFCOUNTING(ByteStream);

  virtual bool ReadAt(int64_t offset, void* data, size_t size,
                      size_t* bytes_read) = 0;
  virtual bool CachedReadAt(int64_t offset, void* data, size_t size,
                            size_t* bytes_read) = 0;
  virtual bool Length(int64_t* size) = 0;

  virtual void DiscardBefore(int64_t offset) {}

  // If this ByteStream's underlying storage of media is in-memory, this
  // function returns a pointer to the in-memory storage of data at offset.
  // Note that even if a ByteStream stores data in memory, it may not be
  // stored contiguously, in which case this returns nullptr.
  virtual const uint8_t* GetContiguousAccess(int64_t aOffset, size_t aSize) {
    return nullptr;
  }

 protected:
  virtual ~ByteStream() = default;
};

}  // namespace mozilla

#endif