1 // ***************************************************************************
2 // IBamIODevice.h (c) 2011 Derek Barnett
3 // Marth Lab, Department of Biology, Boston College
4 // ---------------------------------------------------------------------------
5 // Last modified: 10 November 2011 (DB)
6 // ---------------------------------------------------------------------------
7 // Base class for all BAM I/O devices (e.g. local file, pipe, HTTP, FTP, etc.)
9 // Derived classes should provide protocol-specific implementations for
10 // reading/writing plain bytes, as well as other I/O-related behaviors.
12 // Since IBamIODevices may be defined in client code, the internal
13 // BamExceptions are NOT allowed to be thrown from devices, including the
14 // built-in ones. This keeps a consistent interface at the BgzfStream for
15 // handling any device type. Use the error string for relaying error messages.
16 // ***************************************************************************
18 #ifndef IBAMIODEVICE_H
19 #define IBAMIODEVICE_H
21 #include "api/api_global.h"
27 class API_EXPORT IBamIODevice {
30 public: enum OpenMode { NotOpen = 0x0000
33 , ReadWrite = ReadOnly | WriteOnly
38 virtual ~IBamIODevice(void) { }
40 // IBamIODevice interface
43 // TODO: add seek(pos, *from*)
46 virtual void Close(void) =0;
47 virtual bool IsRandomAccess(void) const =0;
48 virtual bool Open(const OpenMode mode) =0;
49 virtual int64_t Read(char* data, const unsigned int numBytes) =0;
50 virtual bool Seek(const int64_t& position, const int origin = SEEK_SET) =0;
51 virtual int64_t Tell(void) const =0;
52 virtual int64_t Write(const char* data, const unsigned int numBytes) =0;
54 // default implementation provided
55 virtual std::string GetErrorString(void);
56 virtual bool IsOpen(void) const;
57 virtual OpenMode Mode(void) const;
61 IBamIODevice(void); // hidden ctor
62 void SetErrorString(const std::string& where, const std::string& what);
67 std::string m_errorString;
71 IBamIODevice::IBamIODevice(void)
72 : m_mode(IBamIODevice::NotOpen)
76 std::string IBamIODevice::GetErrorString(void) {
81 bool IBamIODevice::IsOpen(void) const {
82 return ( m_mode != IBamIODevice::NotOpen );
86 IBamIODevice::OpenMode IBamIODevice::Mode(void) const {
91 void IBamIODevice::SetErrorString(const std::string& where, const std::string& what) {
92 static const std::string SEPARATOR = ": ";
93 m_errorString = where + SEPARATOR + what;
96 } // namespace BamTools
98 #endif // IBAMIODEVICE_H