mget

从 SFTP 或 FTP 服务器下载文件

全页折叠

语法

mget(s,contents)
mget(s,contents,target)
downloadPaths = mget(___)

说明

mget(s,contents) 从与 s 关联的 SFTP 或 FTP 服务器检索 contents 指定的文件或文件夹，并放入 MATLAB® 当前文件夹中。

示例

mget(s,contents,target) 检索文件或文件夹，并将其放入由 target 中的绝对路径或相对路径指定的本地文件夹中。如果本地文件夹不存在，mget 会创建一个文件夹。

示例

downloadPaths = mget(___) 还以字符向量元胞数组的形式返回下载的文件和文件夹的路径。您可以使用前面任一语法中的输入参量。

示例

全部折叠

打开实时脚本

从 FTP 服务器上下载文本文件并显示其内容。

首先，连接到美国国家环境信息中心 (NCEI) 的 FTP 服务器。

s = ftp('ftp.ngdc.noaa.gov')
  FTP with properties:

                         Host: "ftp.ngdc.noaa.gov"
                     Username: "anonymous"
                         Port: 21
                 ServerLocale: "en_US"
                 DirParserFcn: @matlab.io.ftp.parseDirListingForUnix
                         Mode: "binary"
    LocalDataConnectionMethod: "passive"
       RemoteWorkingDirectory: "/"
          CertificateFilename: "default"
            ConnectionTimeout: 5 min
              TransferTimeout: Inf sec

下载文本文件。mget 函数将文件下载到您计算机上的当前文件夹中。

mget(s,'README.txt');

显示 README.txt 的开头。要读取下载到您计算机上的 README.txt 副本，请使用 fileread 函数。

readme = fileread('README.txt');
readme(1:95)
ans = 
    '                 Welcome to the 
         NOAA/National Centers for Environmental Information (NCEI)'

FTP 服务由美国国家环境信息中心 (NCEI) 提供。有关 NCEI 服务条款，请参阅 NCEI 隐私政策、免责声明和版权。

打开实时脚本

将文本文件从 FTP 服务器下载到您本地计算机上的指定文件夹中。

首先，连接到美国国家环境信息中心 (NCEI) 的 FTP 服务器。

s = ftp('ftp.ngdc.noaa.gov')
  FTP with properties:

                         Host: "ftp.ngdc.noaa.gov"
                     Username: "anonymous"
                         Port: 21
                 ServerLocale: "en_US"
                 DirParserFcn: @matlab.io.ftp.parseDirListingForUnix
                         Mode: "binary"
    LocalDataConnectionMethod: "passive"
       RemoteWorkingDirectory: "/"
          CertificateFilename: "default"
            ConnectionTimeout: 5 min
              TransferTimeout: Inf sec

将文本文件下载到名为 myLocalFolder 的文件夹中。如果此文件夹不存在，mget 函数会在您的本地计算机上创建一个文件夹。

mget(s,'README.txt','myLocalFolder');

使用 fileread 函数读取 README.txt 的开头部分。

readme = fileread('myLocalFolder/README.txt');
readme(1:95)
ans = 
    '                 Welcome to the 
         NOAA/National Centers for Environmental Information (NCEI)'

FTP 服务由美国国家环境信息中心 (NCEI) 提供。有关 NCEI 服务条款，请参阅 NCEI 隐私政策、免责声明和版权。

输入参数

全部折叠

与 SFTP 或 FTP 服务器的连接，指定为 SFTP 对象或 FTP 对象。

远程文件或文件夹，指定为字符向量或字符串标量。

要匹配 SFTP 或 FTP 服务器上的多个文件或文件夹，可以在 contents 中包含一个通配符 (*)。例如，如果您将 contents 指定为 *.docx，则 mget 会下载名称以 .docx 结尾的所有文件。

本地文件夹，指定为字符向量或字符串标量。target 可以指定相对路径或绝对路径。

版本历史记录

在 R2006a 之前推出

另请参阅

| | |