File.h

/*
** libutil++
** $Id: File.h 1669 2016-04-09 20:07:12Z sella $
** Copyright (c) 2011-2016 Digital Genesis, LLC. All Rights Reserved.
** Released under the LGPL Version 2.1 License.
** http://www.digitalgenesis.com
*/

#ifndef __libutilxx__sella__util__File_H__
#define __libutilxx__sella__util__File_H__

#include "../../common.h"
#include "FileException.h"

#include <limits.h>
#include <stdlib.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <unistd.h>

#include <sys/types.h>
#include <sys/stat.h>
#include <time.h>
#include <stdio.h>
#include <stdlib.h>

#include <iostream>
#include <fstream>

#include <set>
#include <vector>
#include <string>

namespace sella {
        namespace util {
                class File;
        }
}

class sella::util::File {
        public:
                static const std::string any; /* .* */
                static const std::set<uint8_t> all; /* { DT_BLK, DT_CHR, DT_DIR, DT_FIFO, DT_LNK, DT_REG, DT_SOCK, DT_UNKNOWN } */
                static const std::set<uint8_t> regular; /* { DT_REG } */
                static const std::set<uint8_t> files; /* { DT_BLK, DT_CHR, DT_FIFO, DT_LNK, DT_REG, DT_SOCK, DT_UNKNOWN } */
                static const std::set<uint8_t> dirs; /* { DT_DIR } */

        public:
                static std::string getBaseName(const std::string &fullpath) throw ();
                static std::string getDirName(const std::string &fullpath) throw ();
                static std::string getRealPath(const std::string &fullpath) throw (FileException);

                static std::vector<std::string> getDirectory(const std::string &path, const std::string &regex = any, const std::set<uint8_t> &types = all) throw (FileException);

                static std::string read(const std::string &fullpath, size_t limit = 0, std::ios_base::openmode mode = std::ios_base::in) throw (FileException);
                static std::string readline(const std::string &fullpath, char delim = '\n', std::ios_base::openmode mode = std::ios_base::in) throw (FileException);
                static std::vector<std::string> readlines(const std::string &fullpath, size_t limit = 0, char delim = '\n', std::ios_base::openmode mode = std::ios_base::in)  throw (FileException);

                static void write(const std::string &fullpath, const std::string &data, std::ios_base::openmode mode = std::ios_base::out) throw (FileException);

                static bool exists(const std::string &fullpath, bool followSymlink = true) throw ();
                static bool isReadable(const std::string &fullpath) throw ();
                static bool isRegularFile(const std::string &fullpath, bool followSymlink = true) throw (FileException);
                static bool isDirectory(const std::string &fullpath, bool followSymlink = true) throw (FileException);
                static bool isCharacterDevice(const std::string &fullpath, bool followSymlink = true) throw (FileException);
                static bool isBlockDevice(const std::string &fullpath, bool followSymlink = true) throw (FileException);
                static bool isFIFO(const std::string &fullpath, bool followSymlink = true) throw (FileException);
                static bool isSymLink(const std::string &fullpath) throw (FileException);
                static bool isSocket(const std::string &fullpath, bool followSymlink = true) throw (FileException);

                static uid_t getUID(const std::string &fullpath, bool followSymlink = true) throw (FileException);
                static gid_t getGID(const std::string &fullpath, bool followSymlink = true) throw (FileException);
                static int64_t getSize(const std::string &fullpath, bool followSymlink = true) throw (FileException); /* in bytes */
                static int64_t getBlocks(const std::string &fullpath, bool followSymlink = true) throw (FileException);
                static int64_t getBlockSize(const std::string &fullpath, bool followSymlink = true) throw (FileException);
                static time_t getATime(const std::string &fullpath, bool followSymlink = true) throw (FileException);
                static time_t getMTime(const std::string &fullpath, bool followSymlink = true) throw (FileException);
                static time_t getCTime(const std::string &fullpath, bool followSymlink = true) throw (FileException);

                static mode_t itomode(int mode) throw (FileException); 

        private:
                static struct stat getStat(const std::string &fullpath, bool followSymlink = true) throw (FileException);
                static mode_t getMode(const std::string &fullpath, bool followSymlink = true) throw (FileException);
};

#endif

/*
** vim: noet ts=3 sw=3
*/