rename

Rename a file or directory on an FTP server.

Attention: Valid only with Altair Communication Extension.

Syntax

[R, msg] = rename(ftpObj, oldname, newname)

Inputs

ftpObj
FTP object
Type: FTP object
oldname
File or directory to be renamed.
Type: string
newname
New file or directory name.
Type: string

Outputs

R
Returns 0 if successful; returns 1 if not successful.
msg
Returns an error message if the command is not succcessful.

Examples

Rename a file:
% Create the FTP object
ftpObj = ftp('ftp://127.0.0.1:60000','user', 'password');
disp('Contents of the remote root directory:')
dir(ftpObj)
% Rename 'file1.txt' to 'file1_renamed.txt'
rename(ftpObj,'file1.txt','file1_renamed.txt');
% Check that the file is renamed
disp('Contents of the remote root directory after renaming:')
dir(ftpObj)
close(ftpObj);
Contents of the remote root directory:
ans = drwxrwxrwx   1 owner    group           0 Feb 20 11:05 Folder1
drwxrwxrwx   1 owner    group           0 Feb 20 11:05 Folder2
-rw-rw-rw-   1 owner    group           0 Feb 19 08:53 file1.txt
-rw-rw-rw-   1 owner    group           0 Feb 19 08:53 file2.txt

Contents of the remote root directory after renaming:
ans = drwxrwxrwx   1 owner    group           0 Feb 20 11:05 Folder1
drwxrwxrwx   1 owner    group           0 Feb 20 11:05 Folder2
-rw-rw-rw-   1 owner    group           0 Feb 19 08:53 file1_renamed.txt
-rw-rw-rw-   1 owner    group           0 Feb 19 08:53 file2.txt
Rename a directory:
% Create the FTP object
ftpObj = ftp('ftp://127.0.0.1:60000','user', 'password');
disp('Contents of the remote root directory:')
dir(ftpObj)
% Rename 'Folder1' to 'Folder1_renamed'
rename(ftpObj,'Folder1','Folder1_renamed');
% Check that the file is renamed
disp('Contents of the remote root directory after renaming:')
dir(ftpObj)
close(ftpObj);
Contents of the remote root directory:
ans = drwxrwxrwx   1 owner    group           0 Feb 20 11:05 Folder1
drwxrwxrwx   1 owner    group           0 Feb 20 11:05 Folder2
-rw-rw-rw-   1 owner    group           0 Feb 19 08:53 file1.txt
-rw-rw-rw-   1 owner    group           0 Feb 19 08:53 file2.txt

Contents of the remote root directory after renaming:
ans = drwxrwxrwx   1 owner    group           0 Feb 20 11:05 Folder1_renamed
drwxrwxrwx   1 owner    group           0 Feb 20 11:05 Folder2
-rw-rw-rw-   1 owner    group           0 Feb 19 08:53 file1.txt
-rw-rw-rw-   1 owner    group           0 Feb 19 08:53 file2.txt