-// sg_file.hxx -- File I/O routines
-//
+/** \file sg_file.hxx
+ * File I/O routines.
+ */
+
// Written by Curtis Olson, started November 1999.
//
-// Copyright (C) 1999 Curtis L. Olson - curt@flightgear.org
+// Copyright (C) 1999 Curtis L. Olson - http://www.flightgear.org/~curt
//
// This program is free software; you can redistribute it and/or
// modify it under the terms of the GNU General Public License as
SG_USING_STD(string);
+/**
+ * A file I/O class based on SGIOChannel.
+ */
class SGFile : public SGIOChannel {
string file_name;
int fp;
+ bool eof_flag;
public:
+ /**
+ * Create an instance of SGFile.
+ * When calling the constructor you need to provide a file
+ * name. This file is not opened immediately, but instead will be
+ * opened when the open() method is called.
+ * @param file name of file to open
+ */
SGFile( const string& file );
+
+ /** Destructor */
~SGFile();
// open the file based on specified direction
// close file
bool close();
+ /** @return the name of the file being manipulated. */
inline string get_file_name() const { return file_name; }
+
+ /** @return true of eof conditions exists */
+ inline bool eof() const { return eof_flag; };
};