dir

  • Artigo

Exibe uma lista de arquivos e subdiretórios de um diretório. Se usado sem parâmetros, esse comando exibirá o rótulo de volume e o número de série do disco, seguido por uma lista de diretórios e arquivos no disco (incluindo seus nomes e a data e hora em que cada um foi modificado pela última vez). Para arquivos, esse comando exibe a extensão de nome e o tamanho em bytes. Esse comando também exibe o número total de arquivos e diretórios listados, seu tamanho acumulativo e o espaço livre (em bytes) restantes no disco.

O comando dir também pode ser executado no Console de Recuperação do Windows, usando parâmetros diferentes. Para obter mais informações, consulte WinRE (Ambiente de Recuperação do Windows).

Sintaxe

dir [<drive>:][<path>][<filename>] [...] [/p] [/q] [/w] [/d] [/a[[:]<attributes>]][/o[[:]<sortorder>]] [/t[[:]<timefield>]] [/s] [/b] [/l] [/n] [/x] [/c] [/4] [/r]

Parâmetros

Parâmetro Descrição
[<drive>:][<path>] Especifica a unidade e o diretório para o qual queira visualizar uma listagem.
[<filename>] Especifica um determinado arquivo ou grupo de arquivos para o qual queira visualizar uma listagem.
/p Exibe uma tela da listagem por vez. Para ver a próxima tela, pressione qualquer tecla.
/q Exibe informações de propriedade do arquivo.
/w Exibe a listagem em formato largo, com até cinco nomes de arquivo ou nomes de diretório em cada linha.
/d Exibe a listagem no mesmo formato que /w, mas os arquivos são classificados por coluna.
/a[[:]<attributes>] Exibe apenas os nomes desses diretórios e arquivos com os atributos determinados. Caso não use esse parâmetro, o comando exibirá os nomes de todos os arquivos, exceto arquivos ocultos e do sistema. Caso use esse parâmetro sem especificar nenhum atributo, o comando exibirá os nomes de todos os arquivos, incluindo arquivos ocultos e do sistema. A lista de possíveis valores de atributos é:
  • d – Diretórios
  • h – Arquivos ocultos
  • s – Arquivos do sistema
  • a – Pontos de nova análise
  • r – Arquivos somente leitura
  • a – Arquivos prontos para arquivamento
  • i – Arquivos sem conteúdo indexado
Use qualquer combinação desses valores, mas não separe os valores usando espaços. Opcionalmente, use dois-pontos (:) separador ou use um hífen (-) como um prefixo para significar, "não". Por exemplo, usar o atributo -s não mostrará os arquivos do sistema.
/o[[:]<sortorder>] Classifica a saída de acordo com sortorder, que pode ser qualquer combinação dos seguintes valores:
  • n – Alfabeticamente por nome
  • e – Alfabético por extensão
  • g – Diretórios de grupo primeiro
  • s – Por tamanho, o menor primeiro
  • d – Por data/hora, a primeira mais antiga
  • Usar o prefixo - para reverter a ordem de classificação
Vários valores são processados na ordem em que você os lista. Não separe vários valores com espaços, mas, opcionalmente, use dois-pontos (:).

Se sortorder não for especificado, o dir /o listará os diretórios em ordem alfabética, seguidos pelos arquivos, que também são classificados em ordem alfabética.
/t[[:]<timefield>] Especifica qual campo de tempo exibir ou usar para classificação. Os valores de timefield disponíveis são:
  • c – Criação
  • a – Acessado por Último
  • w – Última gravação
/s Lista todas as ocorrências do nome de arquivo determinado no diretório especificado e em todos os subdiretórios.
/b Exibe uma lista de diretórios e arquivos sem informações adicionais. O parâmetro /b substitui /w.
/l Exibe nomes de diretórios e nomes de arquivo não classificados, usando letras minúsculas.
/n Exibe um formato de lista longa com nomes de arquivo na extrema direita da tela.
/x Exibe os nomes curtos gerados para nomes de arquivo não 8dot3. A exibição é igual à exibição de /n, mas o nome curto é inserido antes do nome longo.
/c Exibe o separador de milhar em tamanhos de arquivo. Esse é o comportamento padrão. Use /-c para ocultar separadores.
/4 Exibe anos no formato de quatro dígitos.
/r Exibir fluxos de dados alternativos do arquivo.
/? Exibe a ajuda no prompt de comando.

Comentários

  • Para usar vários parâmetros de nome de arquivo, separe cada nome de arquivo com um espaço, vírgula ou ponto e vírgula.

  • Use os caracteres curinga (* ou ?), para representar um ou mais caracteres de um nome de arquivo e para exibir um subconjunto de arquivos ou subdiretórios.

  • Use o caractere curinga, *, para substituir qualquer cadeia de caracteres, por exemplo:

    • dir *.txt lista todos os arquivos no diretório atual com extensões que começam com .txt, como .txt, .txt1 .txt_old.

    • dir read *.txt lista todos os arquivos no diretório atual que iniciam com leitura e com extensões que iniciam com .txt, como .txt, .txt1 .txt_old.

    • dir read *.* lista todos os arquivos no diretório atual que iniciam com leitura com qualquer extensão.

    O curinga asterisco sempre usa o mapeamento de nome de arquivo curto, portanto, talvez pode obter resultados inesperados. Por exemplo, o diretório a seguir contém dois arquivos (t.txt2 e t97.txt):

    C:\test>dir /x
Volume in drive C has no label.
Volume Serial Number is B86A-EF32

Directory of C:\test

11/30/2004  01:40 PM <DIR>  .
11/30/2004  01:40 PM <DIR> ..
11/30/2004  11:05 AM 0 T97B4~1.TXT t.txt2
11/30/2004  01:16 PM 0 t97.txt

    Espere que a digitação dir t97\* retorne o arquivo t97.txt. No entanto, digitar dir t97\* retorna ambos os arquivos, pois o curinga do asterisco corresponde ao arquivo t.txt2 para t97.txt usando seu mapa de nome curto T97B4~1.TXT. Da mesma forma, digitar del t97\* excluiria ambos os arquivos.

  • Use o ponto de interrogação (?) como um substituto para um único caractere em um nome. Por exemplo, digitar dir read???.txt lista todos os arquivos no diretório atual com a extensão .txt que iniciam com leitura e são seguidos por até três caracteres. Isso inclui Read.txt, Read1.txt, Read12.txt, Read123.txt e Readme1.txt, mas não Readme12.txt.

  • Use /a com mais de um valor em atributos, esse comando exibirá os nomes apenas desses arquivos com todos os atributos especificados. Por exemplo, caso use /a com atributos r e -h como (usando /a:r-h ou /ar-h), esse comando exibirá apenas os nomes dos arquivos somente leitura que não estão ocultos.

  • Caso especifique mais de um valor de sortorder, esse comando classificará os nomes de arquivo pelo primeiro critério, depois pelo segundo critério e assim por diante. Por exemplo, caso use /o com os parâmetros e e -s para sortorder (usando /o:e-sou /oe-s), esse comando classificará os nomes de diretórios e arquivos por extensão, com o maior primeiro e exibirá o resultado final. A classificação alfabética por extensão faz com que nomes de arquivo sem extensões apareçam primeiro, depois nomes de diretório e, em seguida, nomes de arquivo com extensões.

  • Caso use o símbolo de redirecionamento (>) para enviar a saída desse comando para um arquivo ou caso use um pipe (|) para enviar a saída desse comando para outro comando, deverá usar /a:-d e /b para listar apenas os nomes de arquivo. Use o filename com /b e /s para especificar que esse comando é pesquisar o diretório atual e seus subdiretórios em busca de todos os nomes de arquivo que correspondam ao nome do arquivo. Esse comando lista apenas a letra da unidade, o nome do diretório, o nome do arquivo e a extensão de nome de arquivo (um caminho por linha) para cada nome de arquivo encontrado. Antes de usar um pipe para enviar a saída desse comando para outro comando, defina a variável de ambiente TEMP no arquivo Autoexec.nt.

Exemplos

Para exibir todos os diretórios um após o outro, em ordem alfabética, em formato largo e pausando após cada tela, verifique se o diretório raiz é o diretório atual e digite:

dir /s/w/o/p

A saída lista o diretório raiz, os subdiretórios e os arquivos no diretório raiz, incluindo extensões. Esse comando também lista os nomes de subdiretório e os nomes de arquivo em cada subdiretório na árvore.

Para alterar o exemplo anterior para que dir exiba os nomes de arquivo e extensões, mas omita os nomes de diretório, digite:

dir /s/w/o/p/a:-d

Para imprimir uma listagem de diretório, digite:

dir > prn

Ao especificar prn, a lista de diretórios é enviada para a impressora anexada à porta LPT1. Se a impressora estiver anexada a uma porta diferente, você deverá substituir prn pelo 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. Você também pode digitar um caminho. Por exemplo, para direcionar a saída dir para o arquivo dir.doc no diretório Registros, digite:

dir > \records\dir.doc

Se dir.doc não existir, o dir o criará, a menos que o diretório Registros não exista. Nesse caso, a seguinte mensagem é exibida:

File creation error

Para exibir uma lista de todos os nomes de arquivo com a extensão .txt em todos os diretórios na unidade C, digite:

dir c:\*.txt /w/o/s/p

O comando dir exibe, em formato largo, uma lista alfabética dos nomes de arquivo correspondentes em cada diretório e pausa cada vez que a tela é preenchida até que é pressionado qualquer tecla para continuar.