path: root/src/fs/virtfsdir.h

/*
 *  The ManaPlus Client
 *  Copyright (C) 2013-2017  The ManaPlus Developers
 *
 *  This file is part of The ManaPlus Client.
 *
 *  This program 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
 *  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 this program.  If not, see <http://www.gnu.org/licenses/>.
 */

#ifndef UTILS_VIRTFSDIR_H
#define UTILS_VIRTFSDIR_H

#include "enums/simpletypes/append.h"
#include "enums/simpletypes/skiperror.h"

#include "localconsts.h"

#include <vector>
#include <string>

struct VirtDirEntry;
struct VirtFile;
struct VirtFsFuncs;
struct VirtList;

namespace VirtFsDir
{
    VirtDirEntry *searchEntryByRoot(const std::string &restrict root);
    VirtDirEntry *searchEntryByPath(const std::string &restrict path);
    const char *getBaseDir();
    const char *getUserDir();
    bool addToSearchPath(const std::string &newDir,
                         const Append append);
    bool addToSearchPathSilent(const std::string &newDir,
                               const Append append,
                               const SkipError skipError);
    bool removeFromSearchPath(std::string oldDir);
    bool removeFromSearchPathSilent(std::string oldDir);
    void init(const std::string &restrict name);
    void initFuncs(VirtFsFuncs *restrict const ptr);
    void deinit();
    std::vector<VirtDirEntry*> &getEntries();
    bool exists(const std::string &restrict name);
    VirtList *enumerateFiles(const std::string &restrict dir) RETURNS_NONNULL;
    bool isDirectory(const std::string &restrict dirName);
    bool isSymbolicLink(const std::string &restrict name);
    void freeList(VirtList *restrict const handle);
    VirtFile *openRead(const std::string &restrict filename);
    VirtFile *openWrite(const std::string &restrict filename);
    VirtFile *openAppend(const std::string &restrict filename);
    bool setWriteDir(const std::string &restrict newDir);
    std::string getRealDir(const std::string &restrict filename);
    bool mkdir(const std::string &restrict dirName);
    bool remove(const std::string &restrict filename);
    void permitLinks(const bool val);
    const char *getLastError();
    int64_t read(VirtFile *restrict const handle,
                 void *restrict const buffer,
                 const uint32_t objSize,
                 const uint32_t objCount);
    int64_t write(VirtFile *restrict const file,
                  const void *restrict const buffer,
                  const uint32_t objSize,
                  const uint32_t objCount);
    int close(VirtFile *restrict const file);
    int64_t fileLength(VirtFile *restrict const file);
    int64_t tell(VirtFile *restrict const file);
    int seek(VirtFile *restrict const file,
             const uint64_t pos);
    int eof(VirtFile *restrict const file);
}  // namespace VirtFsDir

#endif  // UTILS_VIRTFSDIR_H