dir
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 é:
|
/o[[:]<sortorder> ] |
Classifica a saída de acordo com sortorder, que pode ser qualquer combinação dos seguintes valores:
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:
|
/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, digitardir 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, digitardel 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-s
ou/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.