X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;f=simgear%2Fio%2Fsg_file.hxx;h=1bf3800de6fcfafd252556b878795982d175d5fa;hb=1f37095087fa7aa3d210ba134058b86c3bd6d69e;hp=00d47143dc6ef47fc534e03082aec5dc208bfbda;hpb=5702bd7ee80b33840b95c8194d7887f45aaa5977;p=simgear.git

diff --git a/simgear/io/sg_file.hxx b/simgear/io/sg_file.hxx
index 00d47143..1bf3800d 100644
--- a/simgear/io/sg_file.hxx
+++ b/simgear/io/sg_file.hxx
@@ -1,8 +1,10 @@
-// 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
@@ -16,7 +18,7 @@
 //
 // You should have received a copy of the GNU General Public License
 // along with this program; if not, write to the Free Software
-// Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
 //
 // $Id$
 
@@ -42,17 +44,35 @@
 
 #include "iochannel.hxx"
 
-FG_USING_STD(string);
+using std::string;
 
 
+/**
+ * A file I/O class based on SGIOChannel.
+ */
 class SGFile : public SGIOChannel {
 
     string file_name;
     int fp;
+    bool eof_flag;
+    // Number of repetitions to play. -1 means loop infinitely.
+    const int repeat;
+    int iteration;              // number of current repetition,
+                                // starting at 0
 
 public:
 
-    SGFile( const string& file );
+    /**
+     * 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
+     * @param repeat On eof restart at the beginning of the file
+     */
+    SGFile( const string& file, int repeat_ = 1 );
+
+    /** Destructor */
     ~SGFile();
 
     // open the file based on specified direction
@@ -73,7 +93,11 @@ public:
     // 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; };
 };