Name

Renames a file on disk

Syntax
	KeyPgDeclareDeclare KeyPgFunctionFunction Name( KeyPgByrefByRef oldname KeyPgAsAs KeyPgConstQualifierConst KeyPgStringString, KeyPgByrefByRef newname KeyPgAsAs 
	KeyPgConstQualifierConst KeyPgStringString ) KeyPgAsAs KeyPgLongLong

Usage
	result = Name( oldname, newname )

Parameters
	oldname
		Name of an existing file.
	newname
		New name of the file.

Return Value
	Returns zero (0) on success and non-zero on failure.

Description
	Renames a file or folder originally called oldname to newname.

	The function is not guaranteed to succeed if a file/folder exists with 
	the same name.  It may  succeed, overwriting the original, or it may 
	fail.  For greater control, KeyPgFileexistsFileExists could be used to test for an 
	existing file, and KeyPgKillKill could be used to delete an existing file 
	beforehand.

Example
	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

Differences from QB
	* In QB, NAME required AS rather than a comma between the old and new 
	  names.  This is because NAME was a language keyword rather than a 
	  function.

See also
	* KeyPgKillKill
	* KeyPgFileexistsFileExists

