RENAME(E)        Perl Programmers Reference Guide       RENAME(E)



NAME
       rename - renames multiple files

SYNOPSIS
       rename [ -v ] perlexpr [ files ]

DESCRIPTION
       "rename" renames the filenames supplied according to the
       rule specified as the first argument.  The perlexpr argu-
       ment is a Perl expression which is expected to modify the
       $_ string in Perl for at least some of the filenames spec-
       ified.  If a given filename is not modified by the expres-
       sion, it will not be renamed.  If no filenames are given
       on the command line, filenames will be read via standard
       input.

       For example, to rename all files matching "*.bak" to strip
       the extension, you might say

               rename 's/\e.bak$//' *.bak

       To translate uppercase names to lower, you'd use

               rename 'y/A-Z/a-z/' *


OPTIONS
       -v      Verbose: print names of files successfully
               renamed.

ENVIRONMENT
       No environment variables are used.

AUTHOR
       Larry Wall

SEE ALSO
       mv(v), perl(l)

DIAGNOSTICS
       If you give an invalid Perl expression you'll get a syntax
       error.

BUGS
       The original "rename" did not check for the existence of
       target filenames, so had to be used with care.  I hope
       I've fixed that (Robin Barker).



perl v5.6.1                 2002-11-30                  RENAME(E)