This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

rename

Rename file on FTP server

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