std::filesystem::last_write_time
Определён в заголовочном файле <filesystem> | ||
|---|---|---|
std::filesystem::file_time_type last_write_time( const std::filesystem::path& p ); | (1) | (начиная с C++17) |
std::filesystem::file_time_type last_write_time( const std::filesystem::path& p,
std::error_code& ec ) noexcept;
| (2) | (начиная с C++17) |
void last_write_time( const std::filesystem::path& p,
std::filesystem::file_time_type new_time );
| (3) | (начиная с C++17) |
void last_write_time( const std::filesystem::path& p,
std::filesystem::file_time_type new_time,
std::error_code& ec ) noexcept;
| (4) | (начиная с C++17) |
1,2) Возвращает время последнего изменения
p, определяемое так, как если бы обращались к члену st_mtime структуры POSIX stat (следование по символическим ссылкам выполняется). Перегрузка без исключений при ошибках возвращает file_time_type::min().
3,4) Изменяет время последнего изменения
p, как если бы вызывалась функция POSIX futimens (следование по символическим ссылкам выполняется).Параметры
| p | - | путь для проверки или изменения |
| new_time | - | новое время изменения |
| ec | - | выходной параметр для сообщения об ошибках в перегрузке без исключений |
Возвращаемое значение
1,2) Время последнего изменения
p.
3,4) (нет)
Исключения
Любая перегрузка, не помеченная как noexcept, может выбросить std::bad_alloc при сбое выделения памяти.
1,3) Выбрасывает
std::filesystem::filesystem_error при ошибках базового API ОС; исключение создаётся с p в качестве первого аргумента-пути и кодом ошибки ОС в качестве аргумента кода ошибки.
2,4) Записывает код ошибки API ОС в параметр
std::error_code&, если вызов API ОС завершается ошибкой, и выполняет ec.clear(), если ошибок нет.Примечания
Не гарантируется, что сразу после установки времени записи значение, возвращаемое (1,2), будет совпадать со значением, переданным в качестве аргумента в (3,4), поскольку точность времени файловой системы может быть выше, чем filesystem::file_time_type.
Пример
#include <chrono>
#include <filesystem>
#include <format>
#include <fstream>
#include <iostream>
using namespace std::chrono_literals;
int main()
{
auto p = std::filesystem::temp_directory_path() / "example.bin";
std::ofstream{p.c_str()}.put('a'); // create file
std::filesystem::file_time_type ftime = std::filesystem::last_write_time(p);
std::cout << std::format("File write time is {}\n", ftime);
// move file write time 1 hour to the future
std::filesystem::last_write_time(p, ftime + 1h);
// read back from the filesystem
ftime = std::filesystem::last_write_time(p);
std::cout << std::format("File write time is {}\n", ftime);
std::filesystem::remove(p);
}
Возможный вывод:
File write time is 2023-09-04 19:33:24.702639224 File write time is 2023-09-04 20:33:24.702639224
См. также
|
(C++17) | представляет значения времени файла (определение типа) |
| получает время последнего изменения данных файла, на который ссылается запись каталога (открытая функция-член std::filesystem::directory_entry) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/filesystem/last_write_time
