-/* $Id$
-
-This file is part of libmspio
-Copyright © 2007 Mikko Rasa, Mikkosoft Productions
-Distributed under the LGPL
-*/
#ifndef MSP_IO_FILE_H_
#define MSP_IO_FILE_H_
#include <string>
#include "base.h"
+#include "buffered.h"
+#include "filtered.h"
#include "seek.h"
namespace Msp {
public:
enum CreateMode
{
- C_NONE=0,
- C_CREATE=1,
- C_TRUNCATE=2
+ C_NONE = 0,
+ C_CREATE = 1,
+ C_TRUNCATE = 2
};
- File(const std::string &, Mode=M_READ, CreateMode =CreateMode(C_CREATE+C_TRUNCATE));
+private:
+ Handle handle;
+public:
+ /** Creates a new file object and opens it. If the create flag is set and
+ write access is requested and the file does exist, it is created. Otherwise
+ a missing file is an error. */
+ File(const std::string &, Mode = M_READ, CreateMode = CreateMode(C_CREATE+C_TRUNCATE));
+ virtual ~File();
+
+ /** Closes the file. Any attempt to access the file after this will cause
+ an exception to be thrown. */
void close();
void set_block(bool);
- void enable_events();
- void sync();
+protected:
+ virtual unsigned do_write(const char *, unsigned);
+ virtual unsigned do_read(char *, unsigned);
- int seek(int, SeekType);
- int tell() const;
+public:
+ virtual void sync();
- Handle get_event_handle() { return handle; }
+ /** Changes the read/write offset of the file. Returns the new offset. */
+ virtual int seek(int, SeekType);
+
+ /** Returns the current read/write offset of the file. */
+ virtual int tell() const;
- ~File();
-private:
- Handle handle;
+ virtual Handle get_event_handle() { return handle; }
- void check_access(Mode) const;
- unsigned do_write(const char *, unsigned);
- unsigned do_read(char *, unsigned);
+private:
+ void check_access(Mode) const;
};
inline File::CreateMode operator|(File::CreateMode m, File::CreateMode n)
-{ return File::CreateMode((int)m|(int)n); }
+{ return File::CreateMode(static_cast<int>(m)|static_cast<int>(n)); }
inline File::CreateMode operator&(File::CreateMode m, File::CreateMode n)
-{ return File::CreateMode((int)m&(int)n); }
+{ return File::CreateMode(static_cast<int>(m)&static_cast<int>(n)); }
inline File::CreateMode operator~(File::CreateMode m)
-{ return File::CreateMode(~(int)m); }
+{ return File::CreateMode(~static_cast<int>(m)); }
+
+typedef Filtered<File, Buffered> BufferedFile;
} // namespace IO
} // namespace Msp