meta data for this page
ibec_MoveFile
The ibec_MoveFile function renames an existing file or a directory (including all its children).
Description
The ibec_MoveFile function will move (rename) either a file or a directory (including all its children) either in the same directory or across directories. The one caveat is that the ibec_MoveFile function will fail on directory moves when the destination is on a different volume.
If the function succeeds, the return value is nonzero. If the function fails, the return value is zero.
This function now supports Unicode (UTF8) file names. You can still use ANSI names, necessary checks and conversion are performed automatically.
Syntax
function ibec_MoveFile(ExistingFileName, NewFileName : string) : Boolean;
Example
execute IBEBlock
returns (cout varchar(100))
as
begin
if (ibec_MoveFile('d:\txt.csv', 'd:\txtcopy.csv')) then
cout = 'Operation completed!';
else
cout = 'Operation NOT completed!';
suspend;
end