Contact us FAQ Forum
Try it FREE
Home Features Download Purchase Support Solutions

Rename Files or Folders

Rename one or more existing files or folders. The format control tags are supported.

Parameters

  • Source

    • Specifies a full-qualified path and filename. The standard Microsoft MS-DOS wild cards are permitted in the file-name position. Multiple file names may be specified by separating entries with a semi-colon. For example: c:\documents\*.*, c:\documents\*.doc;*.jpg;*.inc. It will have unpredictable results, if you use the relative paths.

  • Exclude mask

    • Specifies one or more source file names which don't move at this operation. Each file name must be terminated by a single semicolon, and standard Microsoft MS-DOS wild cards, such as "*", are permitted in the file-name position. The wild cards name "*.*" does not allowed.

  • Match case

    • Specifies whether the search finds the source files which names match the case of characters in the Files or folder name exactly.

  • Include sub-folders

    • Specifies whether the search extends to the sub-folders of the Source folder.

  • Destination name(Format-control string)

    • Specifies the new name for the file or folder, the format control tags can be placed in the name position, for more information about the format control tag, please see the remark.

  • If destination name has been used

    • Specifies the action when the destination name has been used by another file or folder, it can be:
    • Ignore, don't try to rename the file
    • Add a number at end of file name

  • Allow to rename folder

    • Specifies whether to rename the folder.

  • Sequence number for all sub-folder(s)

    • Specifies how to use the sequence number. With the option checked, all files use one index number, it makes sure that the name of the file is uniquely under the specified folder, no matter where it is.

    Remark:

    The destination name can contain one or more format control tags which are special codes used to generate an actual file name. A tag consists of a left angle bracket <, a type character, and a right angle bracket >. For example, to get the source file name you may insert the tag "<s>" in the destination name parameter. The type character such as the "s" in the <s> is case sensitive. Therefore, the "<m>" and "<M>" will do different the thing - "<m>" get the month of the current date, and "<M>" get the minute of the current time.

    Notes
     The file main name and extension name will be handled respectively. For example, a file name "hello.txt" and the destination name control string is "<s>", a new name "hello" will be generated, if you want to get a full name, the destination name control string should be "<s>.<s>".

    The following table is the tags that are permitted in the destination name.

    TagDescription
    <s>Original file name.
    <sl>Original file name in lowercase
    <su>Original file name in uppercase
    <lx>Get left x characters from the original name
    <llx>Get left x characters from the original name in lowercase.
    <lux>Get left x characters from the original name in uppercase
    <rx>Get right x characters from the original name
    <rlx>Get right x characters from the original name in lowercase
    <rux>Get right x characters from the original name in uppercase
    <ix,n>Get a sub-string from the orginal name n characters from the original name, starting at position x (zero-based).
    <ilx,n>In lowercase, get a sub-string from the orginal name n characters from the original name, starting at position x (zero-based).
    <iux,n>In uppercase, Get a sub-string from the orginal name n characters from the original name, starting at position x (zero-based).
     In above i tags, the ,n can be omitted to represent the remainder of the string.
    <n>The index number of the source file in the searching.
    <n?x> The index number of the source file in the searching, with prefix characters. The prefix characters will be added until the minimum width x is reached. For example, the index number is 20 and the format control string of the destination name is "<nA5>"(i.e. the prefix character is 'A' and the width is "5".), a new name "AAA20" is generated.
    <T>The current time
    <D>The current date
    <y>Year of the current date
    <m>Month of the current date
    <d>Day of the current date
    <h>Hour of the current time
    <M>Minute of the current time
    <e>Second of the current time

    Example

  • The original file name : "MacroExpert.txt"

  • The current date and time : "08/05/2005 01:00"

    • Destination name control string Generated new name
    abc.txt abc.txt
    <s>.<s> MacroExpert.txt
    <sl>.<sl> macroexpert.txt
    <su>.<su> MACROEXPERT.TXT
    abc-<su>.<su> abc-MACROEXPERT.TXT
    <l5>.<l3> Macro.txt
    pic<lu5>.<lu3> picMACRO.TXT
    pic-<rl5>.jpg pic-xpert.jpg
    pic-<n03>.jpg pic-001.jpg
    pic-<ll5><n-3>.jpg pic-macro--1.jpg
    pic-<D>.<s> pic-08-05-2005.txt
    <l5>---<i5>.<s> Macro---Expert.txt
    <l5>---<i5,2>.<s> Macro---Ex.txt

    Notes

    You could filter files based on the attribute settings of the source files. For more information, please refer to Attributes Filter.

    To exclude certain sub-folders, the folder name must be preceded by a backslash character \ in the field Exclude mask. For example: \My Pictures;\My Music;.

    Resources & Support
    Support
    Online Manual
    Online Bug Report
    Suggestion & Comments
    Websites
    GS Typing Tutor
    One-hand typing tutor
    Advanced Key and Mouse Recorder
    About
    About Us
    Privacy Policy
    Links
    Mailing List

    Subscribe to our newsletter and receive updates, tips and tricks on how to automate your tasks with Macro Expert.

    Copyright © 2002 - 2015 GrassSoftware. All Rights Reserved.