dir

Список содержимого папки

Описание

dir перечисляет файлы и папки в текущей папке.

пример

dir name Списки файлы и папки , которые соответствуют name. Когда name является папкой, dir содержит список содержимого папки. Задайте name использование абсолютных или относительных имен путей. The name аргумент может включать в себя * подстановочный символ в имени файла и оба * и ** подстановочный символ в имени пути. Символы рядом с ** подстановочный символ должен быть диафрагмами файлов.

пример

listing = dir(name) возвращает атрибуты о name.

Примеры

Просмотр содержимого папки

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

Создайте папку, myfolder, который содержит файлы myfile1.m, myfile2.m, и myfile3.m.

mkdir myfolder
movefile myfile1.m myfolder
movefile myfile2.m myfolder
movefile myfile3.m myfolder

Перечислите файлы в myfolder.

dir myfolder
.          ..         myfile1.m  myfile2.m  myfile3.m  

Поиск файлов, совпадающих с заданным именем

Список всех файлов с .m расширение, содержащее термин my.

Создайте папку, myfolder, который содержит файлы myfile1.m, myfile2.m, и myfile3.txt.

mkdir myfolder
movefile myfile1.m myfolder
movefile myfile2.m myfolder
movefile myfile3.txt myfolder

Список соответствующих файлов в myfolder.

cd myfolder
dir *my*.m
myfile1.m  myfile2.m  

Поиск файлов в подпапках

Список всех файлов в текущей папке и всех подпапок текущей папки.

Создайте папку, myfolder1, который содержит следующие файлы и папки:

myfile1.m
myfolder2
     myfile2.m
     myfolder3
         myfile3.m
mkdir myfolder1
mkdir myfolder1/myfolder2
mkdir myfolder1/myfolder2/myfolder3

movefile myfile1.m myfolder1
movefile myfile2.m myfolder1/myfolder2
movefile myfile3.m myfolder1/myfolder2/myfolder3

Список всех файлов с .m расширение в myfolder1 и все подпапки myfolder1.

cd myfolder1
dir **/*.m
Files Found in Current Folder:

myfile1.m  

Files Found in: myfolder2

myfile2.m  

Files Found in: myfolder2\myfolder3

myfile3.m  

Поиск информации в структуре возврата

Верните список папок myfolder в переменную MyFolderInfo.

Создайте папку, myfolder, который содержит файлы myfile1.m, myfile2.m, и myfile3.m.

mkdir myfolder
movefile myfile1.m myfolder
movefile myfile2.m myfolder
movefile myfile3.m myfolder

Получите список файлов в myfolder. MATLAB возвращает информацию в массиве структур.

MyFolderInfo = dir('myfolder')
MyFolderInfo=5×1 struct array with fields:
    name
    folder
    date
    bytes
    isdir
    datenum

Индексируйте в структуру для доступа к конкретному элементу.

MyFolderInfo(3).name
ans = 
'myfile1.m'

Найти последний измененный файл даты

Получите серийный номер даты последнего изменения файла.

Используйте datenum поле структуры, возвращаемое dir команда. Не используйте datenum функция для преобразования date поле структуры в число. Результаты datenum функции варьируются в зависимости от локали. Вместо этого используйте datenum поле.

MyFileInfo = dir('myfile1.m');
FileDate = MyFileInfo.datenum
FileDate = 7.3647e+05

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

свернуть все

Имя файла или папки, заданное как вектор символов или строковый скаляр. Если name - строка, заключайте ее в круглые скобки. Для примера, dir("FolderName").

Чтобы отобразить файлы и папки в удаленном расположении, name должен содержать полный путь, заданный в качестве равномерного указателя адреса ресурса (URL). Для получения дополнительной информации см. раздел Работа с удаленными данными.

Для поиска нескольких файлов используйте подстановочные знаки в имени файла. Для примера, dir *.txt перечисляет все файлы с txt расширение в текущей папке. Для рекурсивного поиска по папкам и подпапкам в пути используйте подстановочные знаки в имени пути. Для примера, dir */*.txt перечисляет все файлы с txt расширение только одной папки в текущей папке и dir **/*.txt перечисляет все файлы с txt расширение с нулем или более папок в текущей папке. Символы рядом с ** подстановочный символ должен быть диафрагмами файлов.

Примечание

MATLAB® всегда лечит * символ как символ подстановки, даже в файл системах, которые поддержка * в именах файлов.

MATLAB dir функция согласуется с Microsoft® Windows® операционная система dir команда, которая поддерживает краткие имена файлов, сгенерированные DOS.

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

свернуть все

Атрибуты файла, возвращенные как n-by-1 массив структур, где n - количество файлов и папок, возвращаемых dir команда.

В этой таблице показаны поля в структуре.

Имя поля

Описание

Класс

name

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

char

folder

Расположение файла или папки

char

date

Временная метка даты изменения

char

bytes

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

double

isdir

1 если имя является папкой; 0 если имя является файлом

logical

datenum

Дата изменения в качестве серийного номера даты.

double

Совет

  • Чтобы исключить недопустимые значения, возвращенные dir команда, используйте cellfun функция.

    MyFolderInfo = dir; 
    MyFolderInfo = MyFolderInfo(~cellfun('isempty', {MyFolderInfo.date})); 

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

    date: '' 
    bytes: [] 
    isdir: 0 
    datenum: [] 
    

    В UNIX чаще всего встречаются недопустимые значения® платформы, когда dir запрашивает символьную ссылку, указывающую на несуществующий целевой объект. Несуществующий целевой объект является целевым объектом, который перемещается, удаляется или переименовывается.

  • Чтобы получить список доступных дисков на платформах Microsoft Windows, используйте DOS net use команда в командной строке.

    dos('net use')

    Или тип

    [s,r] = dos('net use')

    MATLAB возвращает результаты в символьный массив r.

Вопросы совместимости

расширить все

Поведение изменено в R2020a

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