You are viewing the version of this documentation from Perl 5.8.0. View the latest version
utime LIST

Changes the access and modification times on each file of a list of files. The first two elements of the list must be the NUMERICAL access and modification times, in that order. Returns the number of files successfully changed. The inode change time of each file is set to the current time. This code has the same effect as the touch command if the files already exist:

$now = time;
utime $now, $now, @ARGV;

If the first two elements of the list are undef, then the utime(2) function in the C library will be called with a null second argument. On most systems, this will set the file's access and modification times to the current time. (i.e. equivalent to the example above.)

utime undef, undef, @ARGV;