Contido
Índice 🔎︎

# Función Dir

Devolve o nome dun ficheiro, dun cartafol, ou de todos os ficheiros e cartafoles dunha unidade ou cartafol que coincidan co camiño de busca especificado.

### Sintaxe:

    Dir [(Text As String [, Attrib As Integer])]

## Valor de retorno:

Cadea

### Parámetros:

Text: Any string expression that specifies the search path, directory or file. This argument can only be specified the first time that you call the Dir function. If you want, you can enter the path in URL notation.

Attrib: Any integer expression that specifies bitwise file attributes. The Dir function only returns files or directories that match the specified attributes. You can combine several attributes by adding the attribute values:

0 : Ficheiros normais.

16 : Devolve só o nome do cartafol.

Use este atributo para verificar se un ficheiro ou cartafol existe ou para determinar os ficheiros e cartafoles dun cartafol específico.

Para verificar se un ficheiro existe, introduza o camiño completo e o nome de ficheiro. Se o nome do ficheiro ou cartafol non existe, a función Dir devove unha cadea de lonxitude cero ("").

To generate a list of all existing files in a specific directory, proceed as follows: The first time you call the Dir function, specify the complete search path for the files, for example, "D:\Files\*.ods". If the path is correct and the search finds at least one file, the Dir function returns the name of the first file that matches the search path. To return additional file names that match the path, call Dir again, but with no arguments.

To return directories only, use the attribute parameter. The same applies if you want to determine the name of a volume (for example, a hard drive partition).

### Códigos de erro

5 Chamada de procedemento incorrecta

53 Ficheiro non atopado

### Exemplo:

    Sub ExampleDir
    REM Mostra todos os ficheiros e cartafoles
    Dim sPath As String
    Dim sDir As String, sValue As String
        sDir="Cartafoles:"
        sPath = CurDir
        sValue = Dir$(sPath + getPathSeparator + "*",16)
        Do
            If sValue <> "." And sValue <> ".." Then
                If (GetAttr( sPath + getPathSeparator + sValue) And 16) >0 Then
                    REM obter os cartafoles
                    sDir = sDir & chr(13) & sValue
                End If
            End If
            sValue = Dir$
        Loop Until sValue = ""
        MsgBox sDir,0,sPath
    End Sub

Temas relacionados

CurDir Function