IFileSystem.h

Go to the documentation of this file.

// Copyright (C) 2002-2011 Nikolaus Gebhardt
// This file is part of the "Irrlicht Engine".
// For conditions of distribution and use, see copyright notice in irrlicht.h

#ifndef __I_FILE_SYSTEM_H_INCLUDED__
#define __I_FILE_SYSTEM_H_INCLUDED__

#include "IReferenceCounted.h"
#include "IXMLReader.h"
#include "IFileArchive.h"

namespace irr
{
namespace video
{
        class IVideoDriver;
} // end namespace video
namespace io
{

class IReadFile;
class IWriteFile;
class IFileList;
class IXMLWriter;
class IAttributes;



class IFileSystem : public virtual IReferenceCounted
{
public:


        virtual IReadFile* createAndOpenFile(const path& filename) =0;


        virtual IReadFile* createMemoryReadFile(void* memory, s32 len, const path& fileName, bool deleteMemoryWhenDropped=false) =0;


        virtual IReadFile* createLimitReadFile(const path& fileName,
                        IReadFile* alreadyOpenedFile, long pos, long areaSize) =0;


        virtual IWriteFile* createMemoryWriteFile(void* memory, s32 len, const path& fileName, bool deleteMemoryWhenDropped=false) =0;



        virtual IWriteFile* createAndWriteFile(const path& filename, bool append=false) =0;


        virtual bool addFileArchive(const path& filename, bool ignoreCase=true,
                        bool ignorePaths=true,
                        E_FILE_ARCHIVE_TYPE archiveType=EFAT_UNKNOWN,
                        const core::stringc& password="",
                        IFileArchive** retArchive=0) =0;


        virtual bool addFileArchive(IReadFile* file, bool ignoreCase=true,
                        bool ignorePaths=true,
                        E_FILE_ARCHIVE_TYPE archiveType=EFAT_UNKNOWN,
                        const core::stringc& password="",
                        IFileArchive** retArchive=0) =0;


        virtual bool addFileArchive(IFileArchive* archive) =0;

        virtual u32 getFileArchiveCount() const =0;


        virtual bool removeFileArchive(u32 index) =0;


        virtual bool removeFileArchive(const path& filename) =0;


        virtual bool removeFileArchive(const IFileArchive* archive) =0;


        virtual bool moveFileArchive(u32 sourceIndex, s32 relative) =0;

        virtual IFileArchive* getFileArchive(u32 index) =0;


        virtual void addArchiveLoader(IArchiveLoader* loader) =0;

        virtual u32 getArchiveLoaderCount() const = 0;


        virtual IArchiveLoader* getArchiveLoader(u32 index) const = 0;


        _IRR_DEPRECATED_ virtual bool addZipFileArchive(const c8* filename, bool ignoreCase=true, bool ignorePaths=true)
        {
                return addFileArchive(filename, ignoreCase, ignorePaths, EFAT_ZIP);
        }


        _IRR_DEPRECATED_ virtual bool addFolderFileArchive(const c8* filename, bool ignoreCase=true, bool ignorePaths=true)
        {
                return addFileArchive(filename, ignoreCase, ignorePaths, EFAT_FOLDER);
        }


        _IRR_DEPRECATED_ virtual bool addPakFileArchive(const c8* filename, bool ignoreCase=true, bool ignorePaths=true)
        {
                return addFileArchive(filename, ignoreCase, ignorePaths, EFAT_PAK);
        }


        virtual const path& getWorkingDirectory() =0;


        virtual bool changeWorkingDirectoryTo(const path& newDirectory) =0;


        virtual path getAbsolutePath(const path& filename) const =0;


        virtual path getFileDir(const path& filename) const =0;


        virtual path getFileBasename(const path& filename, bool keepExtension=true) const =0;

        virtual path& flattenFilename(path& directory, const path& root="/") const =0;

        virtual path getRelativeFilename(const path& filename, const path& directory) const =0;


        virtual IFileList* createFileList() =0;


        virtual IFileList* createEmptyFileList(const io::path& path, bool ignoreCase, bool ignorePaths) =0;

        virtual EFileSystemType setFileListSystem(EFileSystemType listType) =0;


        virtual bool existFile(const path& filename) const =0;


        virtual IXMLReader* createXMLReader(const path& filename) =0;


        virtual IXMLReader* createXMLReader(IReadFile* file) =0;


        virtual IXMLReaderUTF8* createXMLReaderUTF8(const path& filename) =0;


        virtual IXMLReaderUTF8* createXMLReaderUTF8(IReadFile* file) =0;


        virtual IXMLWriter* createXMLWriter(const path& filename) =0;


        virtual IXMLWriter* createXMLWriter(IWriteFile* file) =0;


        virtual IAttributes* createEmptyAttributes(video::IVideoDriver* driver=0) =0;
};


} // end namespace io
} // end namespace irr

#endif