std::experimental::filesystem:: last_write_time
From cppreference.net
<
cpp
|
experimental
|
fs
|
Определено в заголовочном файле
<experimental/filesystem>
|
||
|
file_time_type last_write_time
(
const
path
&
p
)
;
file_time_type last_write_time ( const path & p, error_code & ec ) |
(1) | (filesystem TS) |
|
void
last_write_time
(
const
path
&
p, file_time_type new_time
)
;
void last_write_time ( const path & p, file_time_type new_time, error_code & ec ) ; |
(2) | (filesystem TS) |
1)
Возвращает время последней модификации
p
, определяемое как при доступе к члену
st_mtime
POSIX
stat
(символические ссылки отслеживаются).
Непорождающая перегрузка возвращает
file_time_type
::
min
(
)
при ошибках.
2)
Изменяет время последней модификации
p
, как если бы с помощью POSIX
futimens
(символические ссылки отслеживаются).
Содержание |
Параметры
| p | - | путь для проверки или изменения |
| new_time | - | новое время модификации |
| ec | - | выходной параметр для сообщения об ошибках в непорождающей перегрузке |
Возвращаемое значение
1)
Время последнего изменения
p
.
2)
(нет)
Исключения
The overload that does not take an error_code & parameter throws filesystem_error on underlying OS API errors, constructed with p as the first argument and the OS error code as the error code argument. std:: bad_alloc may be thrown if memory allocation fails. The overload taking an error_code & parameter sets it to the OS API error code if an OS API call fails, and executes ec. clear ( ) if no errors occur. This overload has
noexcept
спецификация:
noexcept
Примечания
Не гарантируется, что сразу после установки времени записи значение, возвращаемое
(1)
, будет совпадать с переданным аргументом в
(2)
, поскольку временная гранулярность файловой системы может быть более детальной, чем
file_time_type
.
Пример
Запустить этот код
#include <chrono> #include <experimental/filesystem> #include <fstream> #include <iomanip> #include <iostream> namespace fs = std::experimental::filesystem; using namespace std::chrono_literals; int main() { fs::path p = fs::current_path() / "example.bin"; std::ofstream(p.c_str()).put('a'); // создать файл auto ftime = fs::last_write_time(p); std::time_t cftime = decltype(ftime)::clock::to_time_t(ftime); // предполагая system_clock std::cout << "File write time is " << std::asctime(std::localtime(&cftime)) << '\n'; fs::last_write_time(p, ftime + 1h); // переместить время записи файла на 1 час вперед ftime = fs::last_write_time(p); // прочитать обратно из файловой системы cftime = decltype(ftime)::clock::to_time_t(ftime); std::cout << "File write time is " << std::asctime(std::localtime(&cftime)) << '\n'; fs::remove(p); }
Возможный вывод:
File write time is Tue Mar 31 19:47:04 2015 File write time is Tue Mar 31 20:47:04 2015
Смотрите также
|
представляет значения времени файла
(typedef) |