DIR
Exibe uma lista dos arquivos e subdiretórios de um diretório. Quando você utiliza DIR sem parâmetros ou opções, o nome do volume e o número de série do disco serão exibidos; um diretório ou nome de arquivo por linha, incluindo a extensão do nome de arquivo, o tamanho do arquivo em bytes, e a data e hora em que o arquivo foi modificado pela última vez; e o número total de arquivos listados, seu tamanho cumulativo e o espaço livre (em bytes) remanescente no disco.
Sintaxe
DIR [unidade:][caminho][nome-de-arquivo] [/P] [/W]
[/A[[:]atributos]][/O[[:]ordem-de-classificação]] [/S] [/B] [/L] [/C]
Parâmetros
[unidade:][caminho]
Especifica a unidade e diretório para os quais você deseja exibir uma lista.
[nome-de-arquivo]
Especifica um arquivo particular ou um grupo de arquivos para o qual você deseja exibir uma lista.
Opções
/P
Exibe a listagem uma tela de cada vez. Para exibir a próxima tela, pressione qualquer tecla.
/W
Exibe a listagem no formato largo, com até‚ cinco nomes de arquivo ou nomes de diretório em cada linha.
/A[[:] atributos]
Exibe somente os nomes daqueles diretórios e arquivos com os atributos especificados. Se esta opção for omitida, DIR exibirá os nomes de todos os arquivos com exceção dos arquivos ocultos e do sistema. Se você utilizar esta opção sem especificar atributos, DIR exibirá os nomes de todos os arquivos, incluindo arquivos ocultos e do sistema. A seguinte lista descreve cada um dos valores que podem ser utilizados como atributos. Os dois pontos (:) são opcionais. Utilize
qualquer combinação destes valores, e certifique-se de não separar os valores com espaços.
H
Arquivos ocultos
-H
Arquivos que não são ocultos
S
Arquivos do sistema
-S
Arquivos que não sejam do sistema
D
Diretórios
-D
Somente arquivos (não diretórios)
A
Arquivos prontos para serem arquivados (cópia de segurança)
-A
Arquivos que não foram alterados desde a última cópia de segurança
R
Arquivos somente para leitura
-R
Arquivos que não são somente para leitura
/O[[:] ordem-de-classificação]
Controla a ordem em que DIR classifica e exibe os nomes de diretório e nomes de arquivo. Se você omitir esta opção, DIR exibirá os nomes na ordem em que ocorrem no diretório. Se você utilizar esta opção sem especificar a ordem de classificação, DIR exibirá os nomes dos diretórios, classificados por ordem alfabética e então exibirá os nomes dos arquivos, classificados por ordem alfabética. Os dois pontos (:) são opcionais. A seguinte lista descreve cada um dos valores que podem ser
utilizados para a ordem de classificação. Utilize qualquer combinação
dos valores sem separa -los com espaços.
N
Em ordem alfabética, pelo nome
-N
Em ordem alfabética reversa pelo nome (Z a A)
E
Em ordem alfabética, pela extensão
-E
Em ordem alfabética reversa pela extensão (Z a A)
D
Pela data e hora, a mais antiga primeiro
-D
Pela data e hora, a mais recente primeiro
S
Pelo tamanho, o menor primeiro
-S
Pelo tamanho, o maior primeiro
G
Com diretórios agrupados antes dos arquivos
-G
Com diretórios agrupados após os arquivos
C
Pela taxa de compactação, a menor primeiro.
-C
Pela taxa de compactação, a maior primeiro.
/S
Lista todas as ocorrências, no diretório especificado e em todos os subdiretórios, do nome de arquivo especificado.
/B
Lista cada nome de diretório ou nome de arquivo, um por linha (incluindo a extensão do nome de arquivo). Esta opção não exibe informações de cabeçalho e resumo. A opção /B substitui a opção /W.
/L
Exibe os nomes de diretório não classificados e os nomes de arquivos em letras minúsculas. Esta opção não converte caracteres estendidos em letras minúsculas.
/C[H]
Exibe a taxa de compactação dos arquivos compactados utilizando o Doublespace ou DriveSpace, baseado em um tamanho de agrupamento de 8K. A opção H opcional exibe a taxa de compactação dos arquivos compactados utilizando Doublespace ou DriveSpace, baseado no tamanho do agrupamento da unidade hospedeira. A opção /C[H] ser ignorada quando utilizada com a opção /W ou /B.
Comandos Relacionados
Para obter informações sobre como exibir a estrutura de diretório de um caminho ou disco, consulte o comando <TREE>.
Para obter informações sobre a compactação de discos, consulte o comando <DRVSPACE>.
Exemplos :
Vamos supor que você deseja exibir todos os arquivos e diretórios de um diretório, incluindo os arquivos ocultos ou do sistema. Para especificar esta exibição, digite o seguinte comando:
dir /a
Vamos supor que você deseja que DIR exiba a listagem de diretórios uma após a outra, até‚ que uma listagem para cada diretório do disco da unidade atual tenha sido exibida. Suponha que você também deseja que o comando DIR classifique cada listagem de diretório, a exiba em formato largo e efetue uma pausa após cada tela. Para especificar este tipo de exibição, certifique-se de que o diretório principal seja o diretório atual e digite o seguinte comando:
dir /s/w/o/p
DIR listar o nome do diretório principal, os nomes dos subdiretórios do diretório principal, e os nomes dos arquivos do diretório principal (incluindo extensões). O comando DIR então listará os nomes dos subdiretórios e os nomes de arquivo de cada subdiretório da árvore do diretório.
Para alterar o exemplo anterior de tal maneira que DIR exiba os nomes de arquivos e extensões mas omita os nomes de diretório, digite o seguinte comando:
dir /s/w/o/p/a:-d
Para imprimir uma listagem do diretório, digite o símbolo de redirecionamento e PRN após qualquer forma do comando DIR, como ilustra o exemplo a seguir:
dir > prn
Quando você especificar PRN na linha de comando DIR, a listagem do diretório será enviada para a impressora anexada … porta LPT1. Se a sua impressora estiver anexada a uma porta diferente, deve-se substituir PRN com o nome da porta correta.
Você também pode redirecionar a saída do comando DIR para um arquivo,
substituindo PRN por um nome de arquivo. Um caminho também será aceito na
linha de comando. Por exemplo, para direcionar a saída de DIR para o arquivo
DIR.DOC no diretório REGISTRO, digite o seguinte comando:
dir > \registro\dir.doc
Se DIR.DOC não existir, o MS-DOS o criará , a menos que o diretório REGISTRO
também não exista. Neste caso, a seguinte mensagem será exibida pelo MS-DOS:
Erro na criação do arquivo
Para exibir uma lista de todos os nomes de arquivos que possuem a extensão
dir c:\*.txt /w/o/s/p
DIR exibirá , em formato largo, uma lista em ordem alfabética dos nomes de arquivos correspondentes de cada diretório e efetuará uma pausa sempre que a tela ficar cheia, até‚ que você pressione uma tecla para continuar.
Observações
Usando curingas com DIR
Você pode utilizar curingas (* e ?) para exibir uma listagem de um subconjunto de arquivos e subdiretórios.
Especificando os atributos de exibição do arquivo
Se você especificar a opção /A com mais de um valor em atributos, DIR exibirá os nomes de somente aqueles arquivos com todos os atributos especificados. Por exemplo, se você especificar a opção /A com os valores R e -H para atributos utilizando /A:R-H ou /AR-H, DIR exibirá somente os nomes dos arquivos somente para leitura que não estão ocultos.
Especificando a classificação de nomes de arquivo
Se você especificar mais de um valor para ordem de classificação, DIR classifica os nomes de arquivos primeiro, pelo primeiro critério, então pelo segundo critério e assim por diante. Por exemplo, se você especificar a opção /O com os valores E e -S para ordem de classificação utilizando /O:E-S ou /OE-S, DIR classifica os nomes de diretórios e arquivos pela extensão, com a maior primeiro e exibe o resultado final. A classificação alfabética pela extensão faz com que os nomes de arquivos sem extensões sejam exibidos primeiro, seguido dos nomes de diretórios e então os nomes de arquivos com extensões.
Definindo formatos de data e hora
Os formatos de data e hora utilizados por DIR dependem da definição do país (country) utilizada no arquivo CONFIG.SYS. Se você não utilizar o comando COUNTRY, os formatos são os mesmos que são utilizados para os Estados Unidos.
Usando os símbolos e conexões de redirecionamento
Quando você utilizar um símbolo de redirecionamento (>) para enviar a saída do DIR para um arquivo ou uma conexão (|) para enviar a saída do DIR para um outro comando, utilize as opções /A:-D e /B para listar somente os nomes de arquivos. Você pode utilizar o parâmetro nome de arquivo com as opções /B e /S para especificar que DIR deve pesquisar o diretório atual e seus subdiretórios para localizar todos os nomes de arquivos que correspondem ao nome de arquivo. DIR lista somente a letra da unidade, nome do diretório, nome de arquivo e extensão do nome de arquivo, um caminho por linha, para cada nome de arquivo que for encontrado.
Antes de utilizar uma conexão para o redirecionamento, deve-se definir a variável de ambiente TEMP no arquivo AUTOEXEC.BAT. Caso contrário, o arquivo temporário será exibido na listagem de diretórios.
Predefinindo os parâmetros e opções do comando DIR
Você pode predefinir os parâmetros e opções do comando DIR incluindo o comando SET com a variável de ambiente DIRCMD no arquivo AUTOEXEC.BAT.
Pode-se utilizar qualquer combinação válida para os parâmetros e opções do comando DIR com o comando SET DIRCMD, incluindo o local e nome de um arquivo.
Por exemplo, para utilizar a variável de ambiente DIRCMD para definir o formato de exibição larga (/W) como formato padrão, inclua o seguinte comando no arquivo AUTOEXEC.BAT:
set dircmd=/w
Para uma única utilização do comando DIR, você pode substituir uma opção que foi definida com a utilização da variável de ambiente DIRCM. Para fazer isto, utilize a mesma opção na linha de comando DIR, mas certifique-se também de preceder a letra da opção com um sinal de subtração, como no exemplo a seguir:
dir /-w
Você pode alterar as definições padrões de DIRCMD digitando o comando SET no aviso de comandos com um novo parâmetro ou opção após o sinal de igualdade (=). As novas definições padrões estarão em efeito para todos os comandos DIR subseqüentes até o momento em que você utilizar o comando SET DIRCMD novamente na linha de comando ou o MS-DOS for reiniciado .
Para limpar todas as definições padrões, digite o seguinte comando:
set dircmd=
Você pode exibir as definições atuais da variável de ambiente DIRCMD digitando o seguinte comando:
set
O MS-DOS exibirá uma lista de variáveis de ambiente com suas definições. Para maiores informações sobre a definição de variáveis de ambiente, consulte o comando <SET>.
