Summary
Modifies the file name. Parameter 1 designates the CF Card data folder. Parameter 2 designates the original file name. Parameter 3 designates the new name.
Format
_CF_rename/_USB_rename (Folder name, File name, New file name)
The file name can also be specified indirectly using internal addresses.
Parameter 1
Folder name: Fixed string (Maximum length is 32 single-byte characters)
Parameter 2
File name: Fixed string (Maximum length is 32 single-byte characters), Internal Device (Maximum length is 14 single-byte characters), Internal Device designated with offset (Internal Device + Temporary address, Maximum length is 14 single-byte characters)
Parameter 3
File name: Fixed string (Maximum length is 12 single-byte characters), Internal Device (Maximum length is 12 single-byte characters), Internal Device designated with offset (Internal Device + Temporary address, Maximum length is 12 single-byte characters)
Example expression:
_CF_rename ("\DATA","DATA0001.BIN","DATA1234.BIN")
In the above example, "\DATA\DATA0001.BIN" file is renamed "\DATA\DATA1234.BIN".
Only the 8.3 format (a maximum of 12 characters, with 8 characters for the file name, the period, and 3 characters for the extension) can be used for the file name. You cannot use file names longer than 12 characters.
Maximum length of parameter 1 folder name is 32 single-byte characters.
The folder name can be appended to the parameter 2 file name. Maximum length of parameter 2 folder name + file name is 32 single-byte characters.
For example, \DATA\01\DATA.bin
An Internal Device can be specified for the second and third parameters (File names). Specifying Internal Device allows indirect addressing of a file name. Also, when specifying parameter 2 internal devices, the maximum folder name + file name length is 14 single-byte characters.
For example,
_CF_rename ("\DATA", [w:[#INTERNAL]LS0100], [w:[#INTERNAL]LS0200])
By storing the file name in LS0100 and LS0200, you can specify file names indirectly.
You cannot append a folder name to the third parameter's file name. If a folder name is appended, it will be ignored.
Store the file name in LS0100 through LS0106 as follows.
When the above script is run, "\DATA\DATA0001.BIN" file is renamed "\DATA\DATA1234.BIN".
When the LS Area is specified for "File name", it is not counted as a D-Script Address.
To specify a root folder, specify " " (empty string) as the folder name.
To specify a full path for a file name, specify "*" (asterisk) as the folder name.
A folder name (directory name) cannot be changed.