Perl 5 version 8.0 documentation

utime

  • 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:

    1. #!/usr/bin/perl
    2. $now = time;
    3. 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.)

    1. utime undef, undef, @ARGV;