Main Content

mput

Upload file or folder to SFTP or FTP server

collapse all in page

Syntax

mput(s,contents)
uploadPaths = mput(s,contents)

Description

mput(s,contents) uploads the files or folders specified by contents to the current folder on the SFTP or FTP server associated with s.

example

uploadPaths = mput(s,contents) returns a cell array that lists the paths to the uploaded files on the server.

Examples

collapse all

Connect to an FTP server and upload files from your local machine to 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 files to that server, then you can use the mput function as shown in this example.

First, connect to the server.

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: "/"

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

dir(s)

 
myscript.m                  README.txt                pub

Upload a file from your local machine to the FTP server.

mput(s,'myNewScript.m');

Display the updated contents on the FTP server, including the new myNewScript.m file.

dir(s)

 
myscript.m                  myNewScript.m           README.txt
pub

Upload multiple files. If the file names have some text in common, then you can use a wildcard character (*) to match the rest of the names. In this example, use a wildcard to match the file names image001.png, image002.png, and image003.png on your local machine.

mput(s,'image*png');

Display the updated contents on the FTP server.

dir(s)

 
image001.png                image002.png            image003.png
myscript.m                  myNewScript.m           README.txt
pub

Input Arguments

collapse all

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

Local files or folders, specified as a character vector or string scalar.

To match multiple files or folders on your local machine, you can include a wildcard character (*) in contents. For example, if you specify contents as *.docx, then mput uploads all files whose names end with .docx.

Version History

Introduced before R2006a

See Also

| | | |