NAME

File::Rename - Perl extension for renaming multiple files

SYNOPSIS

use File::Rename qw(rename);		# hide CORE::rename
rename @ARGV, sub { s/\.pl\z/.pm/ }, 1;

use File::Rename;
File::Rename::rename @ARGV, '$_ = lc';

DESCRIPTION

rename( FILES, CODE [, VERBOSE])

rename FILES using CODE, if FILES is empty read list of files from stdin

rename_files( CODE, VERBOSE, FILES)

rename FILES using CODE

rename_list( CODE, VERBOSE, HANDLE [, FILENAME])

rename a list of file read from HANDLE, using CODE

OPTIONS

FILES

List of files to be renamed, for rename must be an array

CODE

Subroutine to change file names, for rename can be a string, otherside a code reference

VERBOSE

Flag for printing names of files successfully renamed, optional for rename

HANDLE

Filehandle to read file names to be renames

FILENAME (Optional)

Name of file that HANDLE reads from

EXPORT

None by default.

ENVIRONMENT

No environment variables are used.

SEE ALSO

mv(1), perl(1), rename (1)

AUTHOR

Robin Barker <RMBarker@cpan.org>

DIAGNOSTICS

Errors from the code argument are not trapped.

COPYRIGHT AND LICENSE

Copyright (C) 2004, 2005, 2006 by Robin Barker

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.4 or, at your option, any later version of Perl 5 you may have available.