1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
|
// **************************************************************************
// * This file is part of the FreeFileSync project. It is distributed under *
// * GNU General Public License: http://www.gnu.org/licenses/gpl-3.0 *
// * Copyright (C) Zenju (zenju AT gmx DOT de) - All Rights Reserved *
// **************************************************************************
#ifndef FILETRAVERSER_H_INCLUDED
#define FILETRAVERSER_H_INCLUDED
#include <cstdint>
#include "zstring.h"
#include "file_id_def.h"
//advanced file traverser returning metadata and hierarchical information on files and directories
namespace zen
{
struct TraverseCallback
{
virtual ~TraverseCallback() {}
struct SymlinkInfo
{
SymlinkInfo() : lastWriteTime() {}
std::int64_t lastWriteTime; //number of seconds since Jan. 1st 1970 UTC
};
struct FileInfo
{
FileInfo() : fileSize(), lastWriteTime(), symlinkInfo() {}
std::uint64_t fileSize; //unit: bytes!
std::int64_t lastWriteTime; //number of seconds since Jan. 1st 1970 UTC
FileId id; //optional: initial if not supported!
const SymlinkInfo* symlinkInfo; //only filled if file is a followed symlink
};
enum HandleLink
{
LINK_FOLLOW, //dereferences link, then calls "onDir()" or "onFile()"
LINK_SKIP
};
enum HandleError
{
ON_ERROR_RETRY,
ON_ERROR_IGNORE
};
virtual void onFile (const Zchar* shortName, const Zstring& filepath, const FileInfo& details) = 0;
virtual HandleLink onSymlink(const Zchar* shortName, const Zstring& linkpath, const SymlinkInfo& details) = 0;
virtual TraverseCallback* onDir (const Zchar* shortName, const Zstring& dirpath) = 0;
//nullptr: ignore directory, non-nullptr: traverse into using the (new) callback => implement releaseDirTraverser() if necessary!
virtual void releaseDirTraverser(TraverseCallback* trav) {}
virtual HandleError reportDirError (const std::wstring& msg, size_t retryNumber) = 0; //failed directory traversal -> consider directory data at current level as incomplete!
virtual HandleError reportItemError(const std::wstring& msg, size_t retryNumber, const Zchar* shortName) = 0; //failed to get data for single file/dir/symlink only!
};
//custom traverser with detail information about files
//- client needs to handle duplicate file reports! (FilePlusTraverser fallback, retrying to read directory contents, ...)
//- directory may end with PATH_SEPARATOR
void traverseFolder(const Zstring& dirpath, TraverseCallback& sink); //noexcept
}
#endif // FILETRAVERSER_H_INCLUDED
|
