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) Устанавливает параметр std::error_code& в код ошибки API операционной системы, если вызов 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

См. также

file_time_type (C++17)	представляет значения времени файла (typedef)
last_write_time	получает время последней модификации данных файла, к которому относится запись каталога (публичный член-функция `std::filesystem::directory_entry`)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/filesystem/last_write_time