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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
|
//
// TemporaryFile.h
//
// Library: Foundation
// Package: Filesystem
// Module: TemporaryFile
//
// Definition of the TemporaryFile class.
//
// Copyright (c) 2004-2006, Applied Informatics Software Engineering GmbH.
// and Contributors.
//
// SPDX-License-Identifier: BSL-1.0
//
#ifndef Foundation_TemporaryFile_INCLUDED
#define Foundation_TemporaryFile_INCLUDED
#include "Poco/Foundation.h"
#include "Poco/File.h"
namespace Poco {
class Foundation_API TemporaryFile: public File
/// The TemporaryFile class helps with the handling
/// of temporary files.
/// A unique name for the temporary file is
/// automatically chosen and the file is placed
/// in the directory reserved for temporary
/// files (see Path::temp()).
/// Obtain the path by calling the path() method
/// (inherited from File).
///
/// The TemporaryFile class does not actually
/// create the file - this is up to the application.
/// The class does, however, delete the temporary
/// file - either in the destructor, or immediately
/// before the application terminates.
///
/// Note: Due to the way the temporary file names are generated,
/// collisions may be possible after 400-500 Million
/// file names generated by a single process.
{
public:
TemporaryFile();
/// Creates the TemporaryFile.
TemporaryFile(const std::string& tempDir);
/// Creates the TemporaryFile using the given directory.
~TemporaryFile();
/// Destroys the TemporaryFile and
/// deletes the corresponding file on
/// disk unless keep() or keepUntilExit()
/// has been called.
void keep();
/// Disables automatic deletion of the file in
/// the destructor.
void keepUntilExit();
/// Disables automatic deletion of the file in
/// the destructor, but registers the file
/// for deletion at process termination.
static void registerForDeletion(const std::string& path);
/// Registers the given file for deletion
/// at process termination.
static std::string tempName(const std::string& tempDir = "");
/// Returns a unique path name for a temporary
/// file in the system's scratch directory (see Path::temp())
/// if tempDir is empty or in the directory specified in tempDir
/// otherwise.
private:
bool _keep;
};
} // namespace Poco
#endif // Foundation_TemporaryFile_INCLUDED
|
