/* -*- mia-c++  -*-
 *
 * This file is part of MIA - a toolbox for medical image analysis 
 * Copyright (c) Leipzig, Madrid 1999-2015 Gert Wollny
 *
 * MIA 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 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with MIA; if not, see <http://www.gnu.org/licenses/>.
 *
 */

#ifndef mia_core_file_hh
#define mia_core_file_hh

#include <cstdio>
#include <string>

#include <mia/core/defines.hh>

NS_MIA_BEGIN
/// Main namespace of this library 

/// typedef of the cstdio file pointer to avoid the *
typedef FILE * PFILE;

/**
   \ingroup io
   
   \brief A wrapper for the \a cstdio file type that closes the file  automatically when 
   the scope is left. 

   This class implements a transparent wrapper around the C stdio FILE type to make it 
   possible that the file is closed autmatically when the scope of the file variable is left. 
   A variable of this type can be used with all the C-stdio functions that take a file 
   pointer as argument.  
*/
class EXPORT_CORE CFile {
public:
	/** constructor
	    \param filename of the file to handle
	    \param from_stdio use \a stdin or \a stdout
	    \param write open for writing or reading
	*/
	CFile(const std::string& filename, bool from_stdio, bool write);

	/** destructor, closes file if necessary */
	virtual ~CFile() throw();

	/** \returns the stdio FILE pointer */
	operator PFILE();

	/** \returns true if the file is not open (i.e. the FILE pointer is NULL */
	bool operator ! ()const;

private:
	bool m_must_close;
	bool m_is_pipe;
	FILE *m_file;
};


/** 
   \ingroup io
   
   \brief A stdio FILE for opening a file for reading. 
   
   A simple wrapper for the stdio FILE type that handles opening and closing for
   reading and takes care, whether \a stdin should be used 
*/
class EXPORT_CORE CInputFile: public CFile {
public:

	/** constructor opens the file
	    \param filename is the name of the file to be openend, if it is  "-" then  \a stdin is used
	*/

	CInputFile(const std::string& filename);

	/** constructor opens the file
	    \param filename is the name of the file to be openend
	    \param from_stdin force usage of \a stdin
	*/
	CInputFile(const std::string& filename, bool from_stdin);
};

/** 
   \ingroup io
    \brief A stdio FILE for opening a file for writing. 
    
    A simple wrapper for the stdio FILE type that handles opening and closing for
    writing and takes care, whether \a stdout should be used 
*/
class EXPORT_CORE COutputFile: public CFile {
public:

	/** constructor opens the file
	    \param filename is the name of the file to be openend, if it is  "-" then  \a stdin is used
	*/

	COutputFile(const std::string& filename);

	/** constructor opens the file
	    \param filename is the name of the file to be openend
	    \param from_stdin force usage of \a stdin
	*/
	COutputFile(const std::string& filename, bool from_stdin);
};

NS_MIA_END

#endif
