source: trunk/yat/utility/FileIO.h @ 687

#ifndef _theplu_yat_utility_fileio_
#define _theplu_yat_utility_fileio_ 

// $Id: FileIO.h 687 2006-10-16 23:51:10Z jari $

/*
  Copyright (C) 2004 Jari Häkkinen
  Copyright (C) 2005 Peter Johansson
  Copyright (C) 2006 Jari Häkkinen

  This file is part of the yat library, http://lev.thep.lu.se/trac/yat

  The yat library 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.

  The yat library 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 this program; if not, write to the Free Software
  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
  02111-1307, USA.
*/

#include <string>

#include <unistd.h>

namespace theplu {
namespace yat {
namespace utility {

  ///
  /// FileIO is useful for many common task on files.
  ///
  class FileIO {
  public:

    ///
    /// Check if access permissions match \a mode. \a mode must be
    /// given as r, w, x, or combinations of these letters.
    ///
    /// @return On success (all requested permissions granted), zero
    /// is returned. On error (at least one bit in mode asked for a
    /// permission that is denied, or some other error occurred), -1
    /// is returned, and errno is set appropriately.
    ///
    /// @see access(2)
    ///
    /// @note Checking for write permissions will fail if the file
    /// does not exists. This should be fixed so that when a file does
    /// not exist, permissions to create the file should be returned.
    ///
    int access_rights(const std::string& path,const std::string& bits) const;

    ///
    /// Check whether \a file exists.
    ///
    /// @return True if \a file exists, false otherwise.
    ///
    /// @see access(2)
    ///
    /// @todo Probably stat(2) should be used in favour of
    /// access(2). Change the implementation.
    ///
    inline bool file_exists(const std::string& file) const
      { return !access(file.c_str(),F_OK); }
  };

}}} // of namespace utility, yat, and theplu

#endif