File.SetName (gb)

Static Function SetName ( Path As String, NewName As String ) As String

Sets the file name part of a path, and returns the modified path.

Examples

DIM filePath AS String

PRINT "* A standard type of path"
filePath = "/my/path/file.ext"
PRINT filePath
PRINT File.SetName(filePath, "new-name.new")

PRINT "\n* No extension in new name"
filePath = "/my/path/file.ext"
PRINT filePath
PRINT File.SetName(filePath, "new-name")

PRINT "\n* A path with no file name"
PRINT "* You could end up with an invalid path"
filePath = "/my/path/"
PRINT filePath
PRINT File.SetName(filePath, "new-name.new")

PRINT "\n* A path with only a file name"
filePath = "file.ext"
PRINT filePath
PRINT File.SetName(filePath, "new-name.new")

* A standard type of path
/my/path/file.ext
/my/path/new-name.new

* No extension in new name
/my/path/file.ext
/my/path/new-name

* A path with no file name
* You could end up with an invalid path
/my/path/
/my/new-name.new

* A path with only a file name
file.ext
new-name.new