dir

Перечислите содержание папки на SFTP или FTP-сервере

свернуть все на странице

Синтаксис

dir(s)
dir(s,folder)
dir(s,"ParseOutput",tf)
listing = dir(___)

Описание

пример

dir(s) перечисляет содержимое текущей папки на SFTP или FTP-сервере, сопоставленном с s. Содержимое текущей папки может быть файлами и другими папками.

пример

dir(s,folder) перечисляет содержимое заданной папки.

пример

dir(s,"ParseOutput",tf) возвращает необработанную команду СПИСКА выход как массив строк.

пример

listing = dir(___) возвращает массив структур, который содержит имя, дату модификации и размер каждого элемента. Можно использовать этот синтаксис с входными параметрами любого из предыдущих синтаксисов.

Примеры

свернуть все

Откройте связь с сервером SFTP путем создания объекта SFTP. Загрузите файл и перечислите содержимое подпапок на сервере с помощью объекта SFTP.

Во-первых, свяжите с сервером SFTP в качестве примера.

s = sftp("sftp.example_galapagos.net","maria.silva")
  SFTP with properties:

                         Host: "sftp.example_galapagos.net"
                     Username: "maria.silva"
                         Port: 22
                 ServerSystem: "unix"
                 DatetimeType: "datetime"
                 ServerLocale: "en_US"
                 DirParserFcn: @matlab.io.ftp.parseDirListingForUnix
       RemoteWorkingDirectory: "/home/maria.silva"

Перечислите содержимое папки верхнего уровня.

dir(s)
 
air_quality                  fish                        insects                       README.txt
birds                        INDEX.txt                   mammals                       reptiles
climate                      index.html                  rainfall                      sftp.html

Перечислите содержимое подпапки с помощью dir функция.

dir(s,"home/maria.silva/birds")
 
albatrosses                 ducks                       herons                     parrots 
avocets_stilts              falcons                     kingfishers                pelicans
barn_owls                   flamingos                   mockingbirds               penguins 
blackbirds                  frigatebirds                nightjars                  pheasants 
boobies                     grebes                      northern_storm_petrels     pigeons 
cardinal grosbeaks          guineafowl                  osprey                     plovers 
cormorants                  gulls                       owls                       rails
cuckoos                     hawks                       oystercatcher              sandpipers

Превратитесь в подпапку с помощью cd функция. Выход от cd путь к текущей папке на сервере SFTP, не ваша текущая папка MATLAB.

cd(s,"home/maria.silva/birds/herons")
ans = 
"home/maria.silva/birds/herons"

Перечислите содержимое текущей папки.

dir(s)
documentation             great_egret_data              migration_patterns
great_blue_heron_data     green_heron_data              nesting_behaviors

Проанализируйте необработанный выход сервера SFTP LIST команда.

Во-первых, свяжите с сервером SFTP в качестве примера.

s = sftp("sftp.example_galapagos.net","maria.silva")
  SFTP with properties:

                         Host: "sftp.example_galapagos.net"
                     Username: "maria.silva"
                         Port: 22
                 ServerSystem: "unix"
                 DatetimeType: "datetime"
                 ServerLocale: "en_US"
                 DirParserFcn: @matlab.io.ftp.parseDirListingForUnix
       RemoteWorkingDirectory: "/home/maria.silva"

Перечислите содержимое текущей папки на сервере. Присвойте выходной struct переменной a.

a = dir(s)
a=12×1 struct array with fields:
    name
    isdir
    bytes
    date
    datenum

Проанализируйте необработанный выход команды СПИСКА. Присвойте выводимую строку переменной b.

b = dir(s,"ParseOutput",false)
b = 17x1 string
    "lrwxrwxrwx    1       sftp            32 Nov 05  2014 air_quality"
    "-rw-r--r--   32       sftp          1516 Mar 08  2017 birds"
    "-rw-rw-r--    1       sftp          3766 Apr 18  2020 climate"
    "drwxr-xr-x   36       sftp            31 Jun 04  2016 fish"
    "drwxr-xr-x    1       sftp            52 Oct 08  2009 INDEX.txt"
    "drwxr-xr-x    1       sftp            75 Jan 12  2015 index.html"
    "drwxrwsr-x    5       sftp           673 Jul 02  2018 insects"
    "drwxrwsr-x    3       sftp             2 Jun 11  2017 mammals"
    "-rw-rw-r--    2       sftp          9036 Apr 08  2014 rainfall"
    "drwxrwsr-x    1       sftp            11 Jan 10  2019 README.txt"
    "-rw-rw-r--    3       sftp            43 Sep 14  2021 reptiles"
    "drwxrwxr-x    1       sftp          5328 Oct 02  2009 sftp.html"

Перечислите детали содержимого на сервере SFTP. dir функция может возвратить массив структур, который содержит имя, дату модификации и размер каждого элемента в заданной папке.

Во-первых, свяжите с сервером SFTP в качестве примера.

s = sftp("sftp.example_galapagos.net","maria.silva")
  SFTP with properties:

                         Host: "sftp.example_galapagos.net"
                     Username: "maria.silva"
                         Port: 22
                 ServerSystem: "unix"
                 DatetimeType: "datetime"
                 ServerLocale: "en_US"
                 DirParserFcn: @matlab.io.ftp.parseDirListingForUnix
       RemoteWorkingDirectory: "/home/maria.silva"

Возвратите детали об элементах в папке верхнего уровня на сервере SFTP. Некоторые элементы являются файлами, и другие - папки.

listing = dir(s)
listing =12×1 struct array with fields:
    name
    isdir
    bytes
    date
    datenum

Отобразите детали о первом элементе в текущей папке, которая является папкой под названием air_quality.

listing(1)
ans = struct with fields:
       name: 'air_quality'
      bytes: 64
      isdir: 1
       date: '05-Nov-2014 00:00:00'
    datenum: 735908

Входные параметры

свернуть все

Связь с SFTP или FTP-сервером в виде объекта SFTP или объекта FTP.

Имя целевой папки на SFTP или FTP-сервере в виде вектора символов или строкового скаляра. Чтобы задать папку выше текущей, используйте '..'.

Возвратите необработанную команду СПИСКА выход как массив строк в виде TRUE или FALSE.

Выходные аргументы

свернуть все

Атрибуты содержимого, возвращенные как m- 1 массив структур, где m количество элементов в папке.

Эта таблица показывает поля в структуре.

Имя поляОписаниеТип данных
name

Имя файла или имя папки

char

bytes

Размер элемента в байтах

double

isdir

1 если name папка; 0 если name файл

logical

date

Метка времени даты модификации

char

datenum

Дата модификации как последовательный номер даты

double

Советы

  • dir функциональная сила возвращает массив структур, в котором последние четыре поля являются пустыми или недостающими. Когда dir возвращает структуру с недостающей информацией, это может означать, что объект SFTP или FTP не сконфигурирован для операционной системы, которая работает на SFTP или FTP-сервере. По умолчанию объект SFTP или FTP сконфигурирован, чтобы связать с сервером, запускающим UNIX® операционная система.

Смотрите также

| | | |

Представлено до R2006a

Документация MATLAB

Поддержка

Для просмотра документации необходимо авторизоваться на сайте