Skip to main content
Skip table of contents

(v13) rename_file rename a file

This page applies to Harlequin v13.1r0 and later; and to Harlequin Core but not Harlequin MultiRIP

int32 rename_file ( DEVICELIST *dev, uint8 *file1, uint8 *file2);

This routine renames the file file1 with the new name file2 . If the rename succeeds, then it should return 0 . If the rename fails -1 should be returned.

If no file is named file1 then last_error should return DeviceUndefined . If the device does not support renaming, or the particular filenames are not permitted to be changed, then last_error should return DeviceInvalidAccess . If some other error occurs, then last_error should return DeviceIOError .

Whether an error is returned if a file with name file2 already exists is implementation defined. If possible, the routine should not remove the filename file1 until it is known that the rename will succeed.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.