rename

Rename file on FTP server

collapse all in page

Syntax

rename(ftpobj,oldname,newname)

Description

example

rename(ftpobj,oldname,newname) changes the name of the file oldname to newname in the current folder on the FTP server associated with ftpobj.

Examples

collapse all

Connect to an FTP server and rename a file on the server. This example shows a hypothetical FTP session on ftp.example.com, a machine that does not exist. If you have an account on an FTP server that grants you permission to upload or change files on that server, then you can use the rename function as shown in this example.

First, connect to the server.

ftpobj = ftp('ftp.example.com')

ftpobj = 

  FTP Object
     host: ftp.example.com
     user: anonymous
      dir: /
     mode: binary

Display the contents of the current folder on the FTP server.

dir(ftpobj)

 
myscript.m                  README.txt                pub

Rename a file on the FTP server.

rename(ftpobj,'README.txt','INTRO.txt')

Display the updated contents on the FTP server, including the renamed file.

dir(ftpobj)

INTRO.txt                  myscript.m                pub

Input Arguments

collapse all

Connection to an FTP server, specified as an FTP object.

Original name of the file on the FTP server, specified as a character vector or string scalar.

New name of the file on the FTP server, specified as a character vector or string scalar.

Tips

  • The rename function only renames files on an FTP server. To rename files on your local machine, use the movefile function.

See Also

| | | |

Introduced before R2006a

MATLAB Documentation

Support