rename

SFTP または FTP サーバー上にあるファイルの名前の変更

ページ内をすべて折りたたむ

構文

rename(s,oldname,newname)

説明

rename(s,oldname,newname) は、s に関連付けられた SFTP または FTP サーバー上において、現在のフォルダーにあるファイル oldname の名前を newname に変更します。

例

例

すべて折りたたむ

FTP サーバーに接続し、サーバー上のファイルの名前を変更します。この例では、ftp.example.com (実在しないマシン) での架空 FTP セッションが示されています。ユーザーが FTP サーバー上にアカウントをもち、FTP サーバー上でファイルをアップロードまたは変更する権限がある場合、この例で示すように関数 rename を使用できます。

最初に、サーバーに接続します。

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

FTP with properties:

                         Host: "ftp.example.com"
                     Username: "anonymous"
                         Port: 21
                 ServerLocale: "en_GB"
                 DirParserFcn: @matlab.io.ftp.parseDirListingForUnix
                         Mode: "binary"
    LocalDataConnectionMethod: "passive"
       RemoteWorkingDirectory: "/"

FTP サーバー上の現在のフォルダーの内容を表示します。

dir(s)

 
myscript.m                  README.txt                pub

FTP サーバー上のファイルの名前を変更します。

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

名前が変更されたファイルを含め、FTP サーバー上で更新されたコンテンツを表示します。

dir(s)

INTRO.txt                  myscript.m                pub

入力引数

すべて折りたたむ

SFTP または FTP サーバーへの接続。SFTP オブジェクトまたは FTP オブジェクトとして指定します。

SFTP または FTP サーバー上のファイルの元の名前。文字ベクトルまたは string スカラーとして指定します。

SFTP または FTP サーバー上のファイルの新しい名前。文字ベクトルまたは string スカラーとして指定します。

ヒント

  • 関数 rename は、SFTP または FTP サーバー上のファイルについてのみ、名前を変更します。ローカル マシン上のファイルの名前を変更するには、関数 movefile を使用します。

バージョン履歴

R2006a より前に導入

参考

| | | | |