NAME

• 来源: https://www.freebasic.net/wiki/wikka.php?wakka=KeyPgName
• 最后更新: 2022-03-25

---

重命名磁盘上的文件

语法

declare function Name( byref oldname as const string, byref newname as const string ) as long

用法

result = Name( oldname, newname )

参数

oldname

现有文件的名称。

newname

文件的新名称。

返回值

成功时返回零（0），失败时返回非零值。

说明

将原名为 oldname 的文件或文件夹重命名为 newname。

如果已存在同名的文件/文件夹，该函数不保证一定成功。它可能成功并覆盖原有文件，也可能失败。为了更好地控制，可以使用 FileExists 检测文件是否已存在，并事先使用 Kill 删除已存在的文件。

示例

start GeSHi

Dim OldName As String
Dim NewName As String
Dim result As Long

OldName = "dsc001.jpg"
NewName = "landscape.jpg"

result = Name( OldName, NewName )
If 0 <> result Then
    Print "error renaming " & oldname & " to " & newname & "."
End If

end GeSHi

与QB的区别

• 在QB中，NAME 在旧名和新名之间需要使用 AS 而不是逗号。这是因为 NAME 是一个语言关键字而不是函数。

参见

• Kill
• FileExists

返回 目录