Rename Batch Files Explained

[REN main page]
["Renaming Multiple Files" page]

Index

RenPrefix.bat

Formulating a general procedure for adding a prefix to a number of files in a single directory is made complicated by the REN-bug that allows some files to be renamed more than once if the renamed files meet the specification of the files-to-be-renamed in the REN command.

RenPrefix is a neatly constructed batchfile that sets the hidden attribute of each file in the specified group as it is renamed so that it cannot be re-renamed.

This batch file is slightly modified from an example by Tom Lavedas.

  1. ::RenPrefix.bat adds any number of characters
  2. ::to the beginning of a filename
  3. ::Syntax -
  4. ::RENPREFIX files-to-be-renamed prefito-be-added
  5. %4
  6. LFNFOR On
  7. FOR %%v IN (%1) DO CALL %0 %1 %2 %%v GOTO:Part2
  8. ATTRIB -h %2%1
  9. LFNFOR Off
  10. GOTO End
  11. :Part2
  12. REN %3 %2%3
  13. ATTRIB +h %2%3
  14. :End

Explanation

Line   What it does
1 - 4Preamble
5%4
Replaced by the 4th arguement of the batch file. When first called there are only two arguements so this line is ignored. When the batch recalls itself (in line 7) the 4th arguement is "GOTO:Part2" and this command is executed - ie. lines 6 to 10 are skipped. Note that the usual syntax for GOTO is GOTO Label without the colon, but this would be parsed as two arguments. The colon is accepted as a separator by GOTO but not when read as an arguement.
6LFNFOR On
Long filename support for the subsequent FOR command is switched on.
7FOR %%v IN (%1) DO CALL %0 %1 %2 %%v GOTO:Part2
This FOR...IN...DO construction cycles through the files specified by the "files-to-be-renamed" arguement. For each file it re-CALLs the parent batch file (%0) with four arguements: %1 and %2 are carried through from the arguements supplied initially (files-to-be-renamed and prefito-be-added); %3 is the current value of %v (ie. the file currently being processed by FOR); and %4 is the "GOTO:Part2" string.
What happens is that for each file specified in "files-to-be-renamed" a new instance of RenPrefix.bat is run but on reaching Line 5 control skips to Line 11, runs through the remaining commands and then ends. When all files have been processed, the first instance of the batch moves onto Line 8.
8ATTRIB -h %2%1
After Line 7 has been completed, all specified files (%1) are renamed (to %2%1) and hidden. This line resets the "Hidden" attribute for all the renamed files.
9LFNFOR Off
Resets long filename support for FOR to Off. This line is optional and depends on whether you prefer to have LFNFOR On or Off as your default.
10GOTO End
Causes control to skip to :End
11:Part2
Marks the start of the commands used by the child instances of the batch called in Line 7
12REN %3 %2%3
Adds the specified prefix (%2) to the current file being processed in the FOR...IN...DO construction on Line 7 (%3 (= %v))
13ATTRIB +h %2%3
Sets the hidden attribute on the renamed file. This file is now invisible to REN and so cannot be renamed again.
14:End

Example:

To add "abc" to all filenames in the current folder.
RenPrefix *.* abc

This page last revised:
February 12, 2000.