doc/_z_f_protocol_z_f_file_8h_source.html

#ifndef _ZFI_ZFProtocolZFFile_h_

#define _ZFI_ZFProtocolZFFile_h_


#include "ZFCore/ZFProtocol.h"

#include "../ZFIODef.h"

ZF_NAMESPACE_GLOBAL_BEGIN


ZFPROTOCOL_INTERFACE_BEGIN(ZFLIB_ZFCore, ZFFile)

public:

    virtual zfbool fileIsExist(ZF_IN const zfstring &path) zfpurevirtual;

    virtual zfbool isDir(ZF_IN const zfstring &path) zfpurevirtual;

    virtual zfbool isSymlink(ZF_IN const zfstring &path) zfpurevirtual;

    virtual zfbool readSymlink(

            ZF_IN_OUT zfstring &ret

            , ZF_IN const zfstring &path

            ) zfpurevirtual;


    virtual zfbool filePathCreate(

            ZF_IN const zfstring &path

            , ZF_IN_OPT zfbool autoCreateParent = zffalse

            ) zfpurevirtual;

    virtual zfbool fileRemove(

            ZF_IN const zfstring &path

            , ZF_IN_OPT zfbool isRecursive = zftrue

            , ZF_IN_OPT zfbool isForce = zftrue

            ) zfpurevirtual;

    virtual zfbool fileMove(

            ZF_IN const zfstring &dstPath

            , ZF_IN const zfstring &srcPath

            , ZF_IN_OPT zfbool isForce = zftrue

            ) zfpurevirtual;

    virtual zftimet fileModTime(ZF_IN const zfstring &path) zfpurevirtual;

    virtual zfbool fileModTime(

            ZF_IN const zfstring &path

            , ZF_IN zftimet time

            ) zfpurevirtual;


    virtual zfbool fileFindFirst(

            ZF_IN_OUT ZFIOFindData::Impl &fd

            , ZF_IN const zfstring &path

            ) zfpurevirtual;

    virtual zfbool fileFindNext(ZF_IN_OUT ZFIOFindData::Impl &fd) zfpurevirtual;

    virtual void fileFindClose(ZF_IN_OUT ZFIOFindData::Impl &fd) zfpurevirtual;


    virtual void *fileOpen(

            ZF_IN const zfstring &filePath

            , ZF_IN ZFIOOpenOptionFlags flags

            ) zfpurevirtual;

    virtual zfbool fileClose(ZF_IN void *token) zfpurevirtual;


    virtual zfindex fileTell(ZF_IN void *token) zfpurevirtual;

    virtual zfbool fileSeek(

            ZF_IN void *token

            , ZF_IN zfindex byteSize

            , ZF_IN_OPT ZFSeekPos seekPos = ZFSeekPosBegin

            ) zfpurevirtual;


    virtual zfindex fileRead(

            ZF_IN void *token

            , ZF_IN void *buf

            , ZF_IN zfindex maxByteSize

            ) zfpurevirtual;


    virtual zfindex fileWrite(

            ZF_IN void *token

            , ZF_IN const void *src

            , ZF_IN zfindex maxByteSize

            ) zfpurevirtual;

    virtual void fileFlush(ZF_IN void *token) zfpurevirtual;

ZFPROTOCOL_INTERFACE_END(ZFFile)


ZF_NAMESPACE_GLOBAL_END

#endif // #ifndef _ZFI_ZFProtocolZFFile_h_


ZFLIB_ZFCore
#define ZFLIB_ZFCore
used to export symbols
Definition ZFCoreEnvDef.h:30

zfpurevirtual
#define zfpurevirtual
dummy macro shows that a method is pure virtual method
Definition ZFCoreTypeDef_ClassType.h:68

ZF_IN
#define ZF_IN
dummy macro that shows the param used as required input
Definition ZFCoreTypeDef_ClassType.h:191

ZF_IN_OPT
#define ZF_IN_OPT
dummy macro that shows the param used as optional input
Definition ZFCoreTypeDef_ClassType.h:195

ZF_IN_OUT
#define ZF_IN_OUT
dummy macro that shows the param used as required input and output
Definition ZFCoreTypeDef_ClassType.h:207

zfbool
_ZFT_t_zfbool zfbool
bool type
Definition ZFCoreTypeDef_CoreType.h:103

zfindex
_ZFT_t_zfindex zfindex
similar to size_t, used for index and size only
Definition ZFCoreTypeDef_CoreType.h:154

zftrue
#define zftrue
bool true type
Definition ZFCoreTypeDef_CoreType.h:107

zftimet
_zft_zftimet zftimet
time unit, ensured at least 64 bit, ensured signed
Definition ZFCoreTypeDef_CoreType.h:203

zffalse
#define zffalse
bool false type
Definition ZFCoreTypeDef_CoreType.h:111

ZFSeekPos
ZFSeekPos
seek position similar to SEEK_SET of FILE operation
Definition ZFCoreTypeDef_OtherType.h:47

zfstring
zft_zfstring< zfchar > zfstring
see zft_zfstring
Definition ZFCoreTypeDef_StringType.h:15

ZFIODef.h
abstract IO

ZF_NAMESPACE_GLOBAL_BEGIN
#define ZF_NAMESPACE_GLOBAL_BEGIN
begin namespace ZFFramework
Definition ZFNamespace.h:97

ZF_NAMESPACE_GLOBAL_END
#define ZF_NAMESPACE_GLOBAL_END
end namespace ZFFramework
Definition ZFNamespace.h:98

ZFProtocol.h
protocol definitions for ZFFramework

ZFPROTOCOL_INTERFACE_END
#define ZFPROTOCOL_INTERFACE_END(ModuleName)
for more information, please refer to ZFPROTOCOL_INTERFACE_BEGIN
Definition ZFProtocol.h:412

ZFPROTOCOL_INTERFACE_BEGIN
#define ZFPROTOCOL_INTERFACE_BEGIN(ZFLIB_, ModuleName)
declare a protocol interface for ZFFramework
Definition ZFProtocol.h:406

ZFIOFindData::Impl
for impl to achieve custom find logic
Definition ZFIODef_fwd.h:110

ZFIOOpenOptionFlags
see v_ZFIOOpenOption, ZFIOOpenOptionFlagsToString, ZFIOOpenOptionFlagsFromString
Definition ZFIODef_fwd.h:49

ZFPInterface_ZFFile::fileRead
virtual zfindex fileRead(void *token, void *buf, zfindex maxByteSize)=0
see ZFFileRead

ZFPInterface_ZFFile::fileSeek
virtual zfbool fileSeek(void *token, zfindex byteSize, ZFSeekPos seekPos=ZFSeekPosBegin)=0
see ZFFileSeek

ZFPInterface_ZFFile::fileWrite
virtual zfindex fileWrite(void *token, const void *src, zfindex maxByteSize)=0
see ZFFileWrite

ZFPInterface_ZFFile::fileFindNext
virtual zfbool fileFindNext(ZFIOFindData::Impl &fd)=0
see ZFFileFindNext, fileFindFirst

ZFPInterface_ZFFile::fileMove
virtual zfbool fileMove(const zfstring &dstPath, const zfstring &srcPath, zfbool isForce=_ZFT_t_zftrue)=0
see ZFFileMove

ZFPInterface_ZFFile::fileModTime
virtual zfbool fileModTime(const zfstring &path, zftimet time)=0
see ZFFileModTime

ZFPInterface_ZFFile::isDir
virtual zfbool isDir(const zfstring &path)=0
see ZFFileIsDir

ZFPInterface_ZFFile::fileFindFirst
virtual zfbool fileFindFirst(ZFIOFindData::Impl &fd, const zfstring &path)=0
see ZFFileFindFirst

ZFPInterface_ZFFile::fileModTime
virtual zftimet fileModTime(const zfstring &path)=0
see ZFFileModTime

ZFPInterface_ZFFile::fileOpen
virtual void * fileOpen(const zfstring &filePath, ZFIOOpenOptionFlags flags)=0
see ZFFileOpen

ZFPInterface_ZFFile::fileFindClose
virtual void fileFindClose(ZFIOFindData::Impl &fd)=0
see ZFFileFindClose, fileFindFirst

ZFPInterface_ZFFile::fileFlush
virtual void fileFlush(void *token)=0
see ZFFileFlush

ZFPInterface_ZFFile::filePathCreate
virtual zfbool filePathCreate(const zfstring &path, zfbool autoCreateParent=_ZFT_t_zffalse)=0
see ZFFilePathCreate

ZFPInterface_ZFFile::isSymlink
virtual zfbool isSymlink(const zfstring &path)=0
see ZFFileIsSymlink

ZFPInterface_ZFFile::fileRemove
virtual zfbool fileRemove(const zfstring &path, zfbool isRecursive=_ZFT_t_zftrue, zfbool isForce=_ZFT_t_zftrue)=0
see ZFFileRemove

ZFPInterface_ZFFile::fileTell
virtual zfindex fileTell(void *token)=0
see ZFFileTell

ZFPInterface_ZFFile::fileClose
virtual zfbool fileClose(void *token)=0
see ZFFileClose

ZFPInterface_ZFFile::fileIsExist
virtual zfbool fileIsExist(const zfstring &path)=0
see ZFFileIsExist

ZFPInterface_ZFFile::readSymlink
virtual zfbool readSymlink(zfstring &ret, const zfstring &path)=0
see ZFFileReadSymlink