dir

SFTP 또는 FTP 서버의 폴더 내용 나열

구문

dir(s)

dir(s,folder)

dir(s,"ParseOutput",tf)

listing = dir(___)

설명

dir(s)는 s에 연결된 SFTP 또는 FTP 서버에 있는 현재 폴더의 내용을 나열합니다. 현재 폴더의 내용은 파일과 기타 폴더일 수 있습니다.

dir(s,folder)는 지정된 폴더의 내용을 나열합니다.

dir(s,"ParseOutput",tf)는 원시 LIST 명령 출력값을 string형 배열로 반환합니다.

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의 출력값은 현재 MATLAB 폴더가 아닌 SFTP 서버에 있는 현재 폴더의 경로입니다.

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 

LIST 명령 출력값 구문 분석하기

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"

서버에서 현재 폴더의 내용을 나열합니다. 변수 a에 출력 구조체를 할당합니다.

a = dir(s)

a=12×1 struct array with fields:
    name
    isdir
    bytes
    date
    datenum

LIST 명령의 원시 출력값을 구문 분석합니다. 변수 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

입력 인수

s — SFTP 또는 FTP 서버와의 연결

SFTP 객체 | FTP 객체

SFTP 또는 FTP 서버와의 연결로, SFTP 객체 또는 FTP 객체로 지정됩니다.

folder — 대상 폴더 이름

문자형 벡터 | string형 스칼라

SFTP 또는 FTP 서버의 대상 폴더 이름으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. 현재 폴더의 상위 폴더를 지정하려면 '..'를 사용하십시오.

tf — 원시 LIST 명령 출력값을 string형 배열로 반환할지 여부

true(디폴트 값) | false

원시 LIST 명령 출력값을 string형 배열로 반환할지 여부로, true 또는 false로 지정됩니다.

출력 인수

listing — 내용 특성

구조체형 배열

내용 특성으로, m×1 구조체형 배열로 반환됩니다. 여기서 m은 폴더의 항목 개수입니다.

다음 표에는 구조체의 필드가 나와 있습니다.

필드 이름	설명	데이터형
name	파일 또는 폴더 이름	char
bytes	항목의 크기(바이트)	double
isdir	name이 폴더이면 1, name이 파일이면 0	logical
date	수정 날짜 타임스탬프	char
datenum	날짜 일련 번호 값 형식의 수정 날짜	double

팁

• dir 함수는 마지막 네 개의 필드가 비어 있거나 누락된 구조체형 배열을 반환할 수 있습니다. dir이 누락된 정보가 있는 구조체를 반환할 경우, 이는 SFTP 또는 FTP 서버에서 실행 중인 운영 체제에 대해 SFTP 또는 FTP 객체가 구성되지 않았다는 의미일 수 있습니다. 기본적으로 SFTP 또는 FTP 객체는 UNIX^® 운영 체제를 실행하는 서버에 연결하도록 구성됩니다.

버전 내역

R2006a 이전에 개발됨

참고 항목

cd | sftp | ftp | mkdir | rmdir