DIR — описание команды и примеры использования

Описание

DIR — Выводит список файлов и подкаталогов каталога. Вызванная без параметров команда dir выводит метку тома и серийный номер, за которыми следует список каталогов и файлов на диске, включая их имена, дату и время последнего изменения. Для файлов dir выводит также расширение имени и размер в байтах. Команда dir также выводит общее число перечисленных файлов и каталогов, их общий размер и свободное пространство (в байтах) на диске.

Синтаксис

Параметры

Параметр	Описание
[диск:][путь]	Задание диска и каталога, список файлов которого будет выведен
[имя_файла]	Задание файла или группы файлов, сведения о которых требуется вывести
/p	Постраничный вывод сведений, т. е. с паузой после заполнения экрана. Для продолжения просмотра необходимо нажать любую клавишу
/q	Вывод сведений о владельце файла
/w	Вывод сведений в несколько колонок до пяти имен файлов или каталогов в каждой строке
/d	Соответствует /w, но с сортировкой по столбцам
/a [[:] атрибуты]	Выводит имена только тех файлов и каталогов, которые имеют указанные атрибуты. Если параметр /a не указан, команда dir выводит имена всех файлов, за исключением системных и скрытых. Если параметр /a указан без атрибутов, команда dir выводит имена всех файлов, включая скрытые и системные. Ниже приведен список значений, которые могут быть использованы при задании параметра атрибуты. Двоеточие (:) является необязательным. Значения из таблицы могут использоваться в любых комбинациях без пробела между ними. h — Скрытые файлы s — Системные файлы d — Каталоги a — Файлы, готовые к архивированию r — Файлы, доступные только для чтения -h — Файлы, не являющиеся скрытыми -s — Файлы, не являющиеся системными -d — Только файлы (не каталоги) -a — Файлы, не изменявшиеся после последнего архивирования -r — Файлы, не имеющие атрибута «Только чтение»
/o [[:]порядок_сортировки]	Управление порядком сортировки и вывода имен файлов и каталогов командой dir. Если параметр /o, не задан, команда dir выводит имена в том порядке, в котором они записаны в каталоге. Если параметр /o использован без параметра порядок_сортировки, команда dir выводит имена каталогов в алфавитном порядке, затем — имена файлов в алфавитном порядке. Двоеточие (:) является необязательным. Ниже приведен список значений, которые могут быть использованы при задании параметра порядок_сортировки. Допускается использование любого их сочетания без пробелов между ними. n — Сортировка по именам в алфавитном порядке e — Сортировка по расширениям в алфавитном порядке d — Сортировка по дате и времени от ранних к поздним s — Сортировка по размеру от меньших к большим g — Сортировка с группированием каталогов перед файлами -n — Сортировка по именам в обратном алфавитном порядке (от Z к A) -e — Сортировка по расширению в обратном алфавитном порядке (от .ZZZ к .AAA) -d — Сортировка по дате и времени от поздних к ранним -s — Сортировка по размеру от больших к меньшим -g — Сортировка с группировкой каталогов после файлов
/t [[:]поле_времени]	Задание поля времени для вывода и сортировки. Ниже приведен список значений, которые могут быть использованы при задании параметра поле_времени. c — Создание a — Последнее обращение w — Последняя запись
/s	Перечисление всех случаев обнаружения определенного имени файла в указанном каталоге и всех его подкаталогах
/b	Перечисление каждого имени файла (включая расширение) или каталога на отдельной строке. При использовании параметра /b заголовочные сведения или сводка не выводятся. Параметр /b отменяет параметр /w
/l	Вывод несортированного списка имен каталогов и имен файлов строчными буквами. Параметр /l не позволяет преобразовывать дополнительные символы в строчные
/n	Вывод списка в расширенном формате с именами файлов в правой части экрана
/x	Вывод сокращенных имен файлов файловых систем NTFS и FAT. Формат совпадает с форматом параметра /n, но сокращенные имена выводятся после полных
/c	Вывод разделителя десятичных разрядов в размере файлов
/4	Отображение года в четырехзначном формате
/?	Отображение справки в командной строке

Примечания

• Использование нескольких имен_файлов Допускается использование нескольких имен_файлов. Разделяйте имена файлов пробелом, запятой или точкой с запятой. Для вывода группы файлов допускается применение подстановочных знаков (? и *) в параметре имя_файла.
• Использование подстановочных знаков. Для вывода списка подгруппы файлов и подкаталогов можно использовать подстановочные знаки (? и *).
• Задание атрибутов файлов для вывода. Если параметр /a используется более чем с одним значением параметра атрибуты, команда dir выведет имена только тех файлов, все атрибуты которых совпадают с заданными. Например, при использовании параметра /a со значениями атрибутов r и -h в формате /a:r-h или /ar-h команда dir выведет имена файлов, являющихся одновременно скрытыми и защищенными от записи.
• Указание порядка сортировки имен файлов. Если указано несколько значений порядка_сортировки, команда dir сортирует имена файлов сначала по первому условию, затем — по второму и т. д. Например, если указан ключ /o со значениями e и -sпорядка_сортировки в формате /o:e-s или /oe-s, команда dir отсортирует имена каталогов и файлов по расширениям, затем от больших файлов к меньшим и выведет окончательный результат. В результате сортировки по алфавиту файлы без расширений будут идти вначале, затем имена каталогов, а потом имена файлов с расширениями.
• Использование перенаправления и каналовЧтобы перенаправить вывод команды dir в файл с помощью символа (>) или использовать канал (|) для передачи вывода в другую команду, необходимо использовать параметры команды dir/a:-d и /b для вывода только списка имен файлов. Параметр имя_файла с параметрами /b и /s можно использовать, чтобы указать поиск командой dir в текущем каталоге и его подкаталогах всех файлов, соответствующих значению имя_файла. При этом команда dir выведет только имя диска, имя каталога, имя файла и расширение по одному файлу в строке. Чтобы использовать перенаправление с помощью каналов, в файле Autoexec.nt должна быть установлена переменная среды TEMP.
• Предварительное задание параметров команды dir. Параметры команды dir могут быть предварительно заданы включением команды set для переменной среды DIRCMD в файл Autoexec.nt. В команде set dircmd может быть использована любая допустимая комбинация параметров команды dir, включая расположение и имя файла.Например, чтобы использовать переменную среды DIRCMD для задания вывода в расширенном формате (/w) по умолчанию, в файле Autoexec.nt необходимо ввести следующую строку:set dircmd=/w При однократном использовании команды dir можно отменить параметр с помощью переменной среды DIRCMD. Для этого введите параметр, который требуется отменить, в командной строке dir, указав перед ним знак минус. Например:

dir /-w

Чтобы изменить параметры DIRCMD, используемые по умолчанию, введите следующую команду:

set=новый_параметр

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

Чтобы удалить все параметры по умолчанию, введите следующую команду:

set dircmd=

Чтобы просмотреть текущие параметры переменной среды DIRCMD, введите следующую команду:

set

Команда dir с другими параметрами доступна в консоли восстановления.

Примеры использования

Чтобы вывести подряд все каталоги в алфавитном порядке, в несколько колонок и с паузой после заполнения каждого экрана, убедитесь, что корневой каталог является текущим, и введите следующую команду:

Команда dir выводит имя корневого каталога, имена его подкаталогов и имена файлов (включая расширения) в этом каталоге. Затем выводятся имена подкаталогов и имена файлов в каждом каталоге дерева каталогов.
Для изменения предыдущего примера так, чтобы команда dir не выводила имена каталогов, введите следующую команду:

Чтобы напечатать список каталогов, введите следующую команду:

Если указать параметр prn, список каталогов отправляется на принтер, подключенный к порту LPT1. Если принтер подключен к другому порту, необходимо заменить параметр prn именем этого порта.

Вывод команды dir также может быть направлен в файл при замене prn на имя файла. Кроме того, можно также ввести путь. Например, для направления вывода команды dir в файл Dir.doc в каталоге Records введите следующую команду:

Если файл Dir.doc не существует, команда dir создаст его при условии наличия каталога Records. Если этот каталог не существует, выводится следующее сообщение:

Чтобы вывести список всех файлов с расширением .txt во всех каталогах диска C, введите следующую команду:

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

Windows cmd create dir

Displays a list of a directory’s files and subdirectories. If used without parameters, this command displays the disk’s volume label and serial number, followed by a list of directories and files on the disk (including their names and the date and time each was last modified). For files, this command displays the name extension and the size in bytes. This command also displays the total number of files and directories listed, their cumulative size, and the free space (in bytes) remaining on the disk.

The dir command can also run from the Windows Recovery Console, using different parameters. For more information, see Windows Recovery Environment (WinRE).

Syntax

Parameters

] Specifies the drive and directory for which you want to see a listing. [ ] Specifies a particular file or group of files for which you want to see a listing. /p Displays one screen of the listing at a time. To see the next screen, press any key. /q Displays file ownership information. /w Displays the listing in wide format, with as many as five file names or directory names on each line. /d Displays the listing in the same format as /w, but the files are sorted by column. /a[[:] ] Displays only the names of those directories and files with your specified attributes. If you don’t use this parameter, the command displays the names of all files except hidden and system files. If you use this parameter without specifying any attributes, the command displays the names of all files, including hidden and system files. The list of possible attributes values are:

• d — Directories
• h — Hidden files
• s — System files
• l — Reparse points
• r — Read-only files
• a — Files ready for archiving
• i — Not content indexed files

You can use any combination of these values, but don’t separate your values using spaces. Optionally you can use a colon (:) separator, or you can use a hyphen (-) as a prefix to mean, «not». For example, using the -s attribute won’t show the system files. /o[[:] ] Sorts the output according to sortorder, which can be any combination of the following values:

• n — Alphabetically by name
• e — Alphabetically by extension
• g — Group directories first
• s — By size, smallest first
• d — By date/time, oldest first
• Use the — prefix to reverse the sort order

Multiple values are processed in the order in which you list them. Don’t separate multiple values with spaces, but you can optionally use a colon (:).

If sortorder isn’t specified, dir /o lists the directories alphabetically, followed by the files, which are also sorted alphabetically. /t[[:] ] Specifies which time field to display or to use for sorting. The available timefield values are:

• c — Creation
• a — Last accessed
• w — Last written

/s Lists every occurrence of the specified file name within the specified directory and all subdirectories. /b Displays a bare list of directories and files, with no additional information. The /b parameter overrides /w. /l Displays unsorted directory names and file names, using lowercase. /n Displays a long list format with file names on the far right of the screen. /x Displays the short names generated for non-8dot3 file names. The display is the same as the display for /n, but the short name is inserted before the long name. /c Displays the thousand separator in file sizes. This is the default behavior. Use /c to hide separators. /4 Displays years in four-digit format. /r Display alternate data streams of the file. /? Displays help at the command prompt.

Remarks

To use multiple filename parameters, separate each file name with a space, comma, or semicolon.

You can use wildcard characters (* or ?), to represent one or more characters of a file name and to display a subset of files or subdirectories.

You can use the wildcard character, *, to substitute for any string of characters, for example:

dir *.txt lists all files in the current directory with extensions that begin with .txt, such as .txt, .txt1, .txt_old.

dir read *.txt lists all files in the current directory that begin with read and with extensions that begin with .txt, such as .txt, .txt1, or .txt_old.

dir read *.* lists all files in the current directory that begin with read with any extension.

The asterisk wildcard always uses short file name mapping, so you might get unexpected results. For example, the following directory contains two files (t.txt2 and t97.txt):

You might expect that typing dir t97\* would return the file t97.txt. However, typing dir t97\* returns both files, because the asterisk wildcard matches the file t.txt2 to t97.txt by using its short name map T97B4

1.TXT. Similarly, typing del t97\* would delete both files.

You can use the question mark (?) as a substitute for a single character in a name. For example, typing dir read. txt lists any files in the current directory with the .txt extension that begin with read and are followed by up to three characters. This includes Read.txt, Read1.txt, Read12.txt, Read123.txt, and Readme1.txt, but not Readme12.txt.

If you use /a with more than one value in attributes, this command displays the names of only those files with all the specified attributes. For example, if you use /a with r and -h as attributes (by using either /a:r-h or /ar-h ), this command will only display the names of the read-only files that aren’t hidden.

If you specify more than one sortorder value, this command sorts the file names by the first criterion, then by the second criterion, and so on. For example, if you use /o with the e and -s parameters for sortorder (by using either /o:e-s or /oe-s ), this command sorts the names of directories and files by extension, with the largest first, and then displays the final result. The alphabetic sorting by extension causes file names with no extensions to appear first, then directory names, and then file names with extensions.

If you use the redirection symbol ( > ) to send this command’s output to a file, or if you use a pipe ( | ) to send this command’s output to another command, you must use /a:-d and /b to only list the file names. You can use filename with /b and /s to specify that this command is to search the current directory and its subdirectories for all file names that match filename. This command lists only the drive letter, directory name, file name, and file name extension (one path per line), for each file name it finds. Before you use a pipe to send this command’s output to another command, you should set the TEMP environment variable in your Autoexec.nt file.

Examples

To display all directories one after the other, in alphabetical order, in wide format, and pausing after each screen, make sure that the root directory is the current directory, and then type:

The output lists the root directory, the subdirectories, and the files in the root directory, including extensions. This command also lists the subdirectory names and the file names in each subdirectory in the tree.

To alter the preceding example so that dir displays the file names and extensions, but omits the directory names, type:

To print a directory listing, type:

When you specify prn, the directory list is sent to the printer that is attached to the LPT1 port. If your printer is attached to a different port, you must replace prn with the name of the correct port.

You can also redirect output of the dir command to a file by replacing prn with a file name. You can also type a path. For example, to direct dir output to the file dir.doc in the Records directory, type:

If dir.doc does not exist, dir creates it, unless the Records directory does not exist. In that case, the following message appears:

To display a list of all the file names with the .txt extension in all directories on drive C, type:

The dir command displays, in wide format, an alphabetized list of the matching file names in each directory, and it pauses each time the screen fills until you press any key to continue.