显示指定目录下的文件和子目录列表。
当不带或开关项使用DIR时,它将显示磁盘卷标和序列号;每行显示一个目录或文件,包括它们的扩展名、文件大小(字节)、上次修改的日期和时间;以及所列的文件总数累计大小;以及磁盘剩余空间。
语法:
| DIR [drive:][path][filename] [/P] [/W] [/A[[:]attributes]][/O[[:]sortorder]] [/S] [/B] [/L] |
参数 :
[drive:][path]
指定要列表的驱动器和目录。
[filename]
指定要列表的文件或文件组。
开关项:
/P
每次显示一屏,按任何键可显示下一屏。
/W
按横显示方式显示文件列表,即每行尽可能多的显示文件或目录。
/A[[:] attributes]
显示具有给定属性的文件和目录,如果没有该开关项,DIR将显示除隐藏文件外的所有文件。如果使用该相关项,但不指定属性,则DIR将显示所有文件,包括隐藏文件和系统文件。下面给出了属性列表。冒号(:)是可选的。属性可组合,属性之间不要用空格分开。
H
隐藏文件
-H
非隐藏文件
S
系统文件
-S
非系统文件
D
目录
-D
文件(非目录)
A
需备份的文件
-A
上次备份以来没有改变的文件
R
只读文件
-R
非只读文件
/O[[:] sortorder]
控制显示文件和目录的次序。如果略去此开关项,DIR将依次按它们在目录中的次序显示名字。如果使用此开关项,但没有指定排序方式,DIR按字母顺序显示目录和文件名。冒号(:)是可选的。下面给出了所有排序方式。这些方式可组合使用,中间不要用空格隔开。
N
以文件名的顺序排列
-N
以文件名的字母逆序排列(Z-A)
E
以扩展名的顺序排列
-E
以扩展名的逆序排列(Z-A)
D
以日期和时间的顺序排列,早的在前
-D
以日期和时间的顺序排列,晚的在前
S
以文件大小的顺序排列,短的在前
-S
以文件大小的逆序排列,长的在前
G
目录在前,文件在后
-G
目录在后,文件在前
C
按压缩比例,最小的在前。
-C
按压缩比例,最大的在前。
/S
列表显示在指定目录和其所有子目录中,所有的指定文件
/B
每行列出一个目录或文件名(包括扩展名)。 此开关项不显示头信息和总计。
/B屏蔽/W。
/L
以小写方式,显示非排序的目录和文件名。 该开关项不将扩展字符转换为小写。
/C[H]
使用DoubleSpace或DriveSpace,显示文件的压缩比例。选项开关 H表示以8K为底,显示文件的压缩比例。在使用 /W 或 /B 时,/C[H]开关将被忽略。
相关命令
有关显示路径或磁盘目录结构的信息,请参见 <TREE>命令。
有关压缩磁盘的详细信息,请参阅<DRVSPACE> 命令。
在DIR中使用通配符
使用通配符可显示文件和目录的部分列表。使用通配符的例子,参见"例子"屏。
指定文件显示属性
如果/A开关项带有多个属性值,则DIR将显示带有这些属性的文件。 例如,指定/A开关项,并带有R和-H属性值,可写成/A:R-H或/AR-H,DIR仅显示非隐藏的只读文件。
排序文件名
如果指定了多个排序值,DIR将首先按第一个准则排序,然后按第二个准则,依此类推。 例如,使用/O开关项,并带有E和-S排序值,可写成/O:E-S或/OE-S,DIR将首先按扩展名排序文件和目录,然后再按最大在前的方式排序,并显示最终结果。按扩展名字母顺序排序,将使得无扩展名的文件在最前面,然后是目录名,最后为带扩展名的文件。
设置日期和时间格式
DIR显示的日期和时间格式取决于在CONFIG.SYS文件中有关国家的设置。 如果没有使用COUNTRY命令,则按美国格式显示。
使用重定向和管道
当用重定向符号(>)将DIR的输出发送到一个文件,或使用管道(|)使得DIR输出到其它命令时,可使用/A:-D和/B开关项来列出文件名。 利用/B和/S开关项,以及文件名参数,可指定DIR搜索当前目录及其子目录中的所有匹配文件。 DIR仅列出驱动器字母,目录名,文件名和文件扩展名,每行显示一个路径。
在使用管道之前,应该首先在AUTOEXEC.BAT文件中设置TEMP环境变量;否则,临时文件将出现在目录列表中。
预置DIR参数和开关项
在AUTOEXEC.BAT文件中,可使用SET命令定义DIRCMD环境变量,预先设置DIR的参数和开关项。 在SET DIRCMD中,可使用任何DIR参数和选项的合法组合。包括路径和文件名。
例如,DIRCMD环境变量设置横宽显(/W)为默认格式,在AUTOEXEC.BAT文件中,可执行下面命令:
set dircmd=/w
对于单独使用的DIR命令,您可以通过开关项改变DIRCMD环境变量。若不使用默认设置,可在DIR命令行使用同样的开关项,但前面必须加一减号:
dir /-w
在命令提示符下,可使用SET命令来改变默认设置,影响以后的所有命令,直到再次使用SET DIRCMD或重新启动MS-DOS。
下面命令将清除所有默认设置:
set dircmd=
下面命令查看当前DIRCMD环境变量的设置:
set
MS-DOS将显示所有环境变量及其设置。有关设置环境变量的详细信息,请参见 <SET> 命令。
假设要显示某一目录下的所有文件和目录,包括隐藏文件和系统文件,可使用下面命令:
dir /a
如果显示当前驱动器下所有目录,并依次列表,同时对于每个目录列表按横显格式,并按字母顺序排序,而且一次屏,则可在根目录下使用下面命令:
dir /s/w/o/p
DIR列出了根目录名,根目录下子目录名,以及根目下的所有文件名,然后以目录树的形式列出了子目录名和子目录下所有文件名。
可改变上一例子,使得DIR显示文件名和扩展名,但忽略目录名,命令如下:
dir /s/w/o/p/a:-d
为打印目录列表,可在任何DIR命令之后,给出重定向符和PRN,例如:
dir > prn
当在DIR命令行指明了PRN,则目录列表被送到连接在端口LPT1的打印机上。如果打印机所连接的是其它的端口,你必须用该端口名称来替代PRN。
亦可重新定向输出到一文件,只须用一文件名替代PRN。 在命令行同样可以给出路径,例如,定向DIR的输出到RECORDS目录下的DIR.DOC文件中,可使用下面命令:
dir > \records\dir.doc
如果DIR.DOC文件不存在,MS-DOS将创建它,除非目录RECORDS也不存在,这时,MS-DOS将显示下面的信息:
File creation error
若要显示驱动器C的所有目录中扩展名为.TXT的文件,可使用下面命令:
dir c:\*.txt /w/o/s/p
DIR将按横显格式,字母顺序,且每次只显示一屏。