byte_filer.h

Go to the documentation of this file.

#ifndef BYTE_FILER_CLASS
#define BYTE_FILER_CLASS

/*****************************************************************************\
*                                                                             *
*  Name   : byte_filer                                                        *
*  Author : Chris Koeritz                                                     *
*                                                                             *
*******************************************************************************
* Copyright (c) 2000-$now By Author.  This program is free software; you can  *
* redistribute it and/or modify it under the terms of the GNU General Public  *
* License as published by the Free Software Foundation; either version 2 of   *
* the License or (at your option) any later version.  This is online at:      *
*     http://www.fsf.org/copyleft/gpl.html                                    *
* Please send any updates to: fred@gruntose.com                               *
\*****************************************************************************/


#include "opsysdll.h"

// forward.
class file_hider;

class OPSYSTEM_CLASS_STYLE byte_filer
{
public:
  byte_filer();

  byte_filer(const istring &filename, const istring &permissions);

  byte_filer(const char *filename, const char *permissions);

  byte_filer(bool auto_close, void *opened);

  ~byte_filer();

  static size_t file_size_limit();

  bool open(const istring &filename, const istring &permissions);

  void close();

  istring filename() const;

  bool good();

  size_t length();

  size_t tell();

  void flush();

  enum origins {
    FROM_START,    
    FROM_END,      
    FROM_CURRENT   
  };

  bool seek(int where, origins origin = FROM_START);

  bool eof();

  int read(byte *buffer, int buffer_size);

  int write(const byte *buffer, int buffer_size);

  int read(byte_array &buffer, int desired_size);
  int write(const byte_array &buffer);

  int read(istring &buffer, int desired_size);

  int write(const istring &buffer, bool add_null = false);

  int getline(byte *buffer, int desired_size);
  int getline(byte_array &buffer, int desired_size);
  int getline(istring &buffer, int desired_size);

  bool truncate();

  void *file_handle();

private:
  file_hider *_handle;  
  istring *_filename;  
  bool _auto_close;  

  // not to be called.
  byte_filer(const byte_filer &);
  byte_filer &operator =(const byte_filer &);
};

#endif

---