| Note | 该命令在头文件中定义，将由 X# 预处理器预处理为函数调用。如果禁用标准头文件 (-nostddefs)，该命令将不可用。如果告诉编译器使用不同的标准头文件（-stddef ），则此命令也可能不可用。 |
用途
将文件名更改为新名称。
语法
RENAME <xcSourceFile> TO <xcTargetFile>
参数
| <xcSourceFile> | 要重命名的源文件名，包括可选的驱动器、目录和扩展名。 如果 <xcSourceFile> 不存在，运行时将出错。 |
| TO <xcTargetFile> | 新文件的名称，包括可选的驱动器、目录和扩展名。 如果 <xcTargetFile> 已存在或已打开，RENAME 不会执行任何操作。 |
| SetDefault() 和 SetPath() 不会影响此命令。 如果没有指定驱动器和目录，它将假定当前的 Windows 驱动器和目录。 不提供默认扩展名。 |
描述
如果目标目录与源目录不同，文件会移动到新的目录。
警告！ 重命名前必须关闭文件。 尝试重命名打开的文件将产生不可预知的结果。 重命名数据库文件时，请记住任何相关的备注文件也必须重命名。 否则会影响应用程序的完整性。
示例
此示例重命名了一个文件，在开始 RENAME 操作前检查目标文件是否存在：
xcOldFile := "oldfile.txt"
xcNewFile := "newfile.txt"
IF !File(xcNewFile)
RENAME (xcOldFile) TO (xcNewFile)
ELSE
? "文件已存在"
ENDIF
程序集
XSharp.RT.DLL
参见
COPY FILE, CurDir(), DELETE FILE, File(), FErase(), FRename(), RUN, SetDefault(), SetPath()
