blob: 3065401e952b2e649e2f918b8b1472637bb686c2 [file] [log] [blame]
#pragma once
#include <filesystem>
#include <utility>
namespace util
{
namespace fs = std::filesystem;
/**
* @class TemporaryFile
*
* A temporary file in the file system.
*
* The temporary file is created by the constructor. The absolute path to the
* file can be obtained using getPath().
*
* The temporary file can be deleted by calling remove(). Otherwise the file
* will be deleted by the destructor.
*
* TemporaryFile objects cannot be copied, but they can be moved. This enables
* them to be stored in containers like std::vector.
*/
class TemporaryFile
{
public:
// Specify which compiler-generated methods we want
TemporaryFile(const TemporaryFile&) = delete;
TemporaryFile& operator=(const TemporaryFile&) = delete;
/**
* Constructor.
*
* Creates a temporary file in the temporary directory (normally /tmp).
*
* Throws an exception if the file cannot be created.
*/
TemporaryFile();
/**
* Move constructor.
*
* Transfers ownership of a temporary file.
*
* @param file TemporaryFile object being moved
*/
TemporaryFile(TemporaryFile&& file) : path{std::move(file.path)}
{
// Clear path in other object; after move path is in unspecified state
file.path.clear();
}
/**
* Move assignment operator.
*
* Deletes the temporary file owned by this object. Then transfers
* ownership of the temporary file owned by the other object.
*
* Throws an exception if an error occurs during the deletion.
*
* @param file TemporaryFile object being moved
*/
TemporaryFile& operator=(TemporaryFile&& file);
/**
* Destructor.
*
* Deletes the temporary file if necessary.
*/
~TemporaryFile()
{
try
{
remove();
}
catch (...)
{
// Destructors should not throw exceptions
}
}
/**
* Deletes the temporary file.
*
* Does nothing if the file has already been deleted.
*
* Throws an exception if an error occurs during the deletion.
*/
void remove();
/**
* Returns the absolute path to the temporary file.
*
* Returns an empty path if the file has been deleted.
*
* @return temporary file path
*/
const fs::path& getPath() const
{
return path;
}
private:
/**
* Absolute path to the temporary file.
*
* Empty when file has been deleted.
*/
fs::path path{};
};
} // namespace util