Contenido
Índice 🔎︎

# Función Dir

Devuelve el nombre de un archivo, directorio o todos los archivos y directorios de una unidad o directorio que coincidan con la ruta de acceso de búsqueda especificada.

### Sintaxis:

    Dir [(PathName As String [, Attributes As Integer])]

### Valor de retorno:

Cadena

### Parámetros:

PathName: 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.

Attributes: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 : Archivos normales.

16 : Devuelve solo el nombre de la carpeta.

Este atributo se usa para comprobar si un archivo o directorio existen o para determinar todos los archivos y carpetas de un directorio específico.

Para comprobar si un archivo existe, escriba la ruta de acceso completa y el nombre del archivo. Si el nombre de archivo o de directorio no existen, la función Dir devuelve una cadena de longitud cero ("").

Para generar una lista de todos los archivos de una carpeta específica, proceda de esta manera: La primera vez que llame a la función Dir, especifique la ruta de acceso de búsqueda completa para los archivos, por ejemplo: «D:\Archivos\*.ods». Si la ruta de acceso es correcta y la búsqueda encuentra por lo menos un archivo, la función Dir devuelve el nombre del primer archivo que coincida con la ruta de la búsqueda. Para obtener más nombres de archivo que coincidan con la ruta de acceso, llame a Dir de nuevo, pero sin argumentos.

Para que solo se devuelvan directorios, use el parámetro de atributo. Lo mismo se aplica si se desea determinar el nombre de un volumen (por ejemplo, una partición de disco duro).

### Códigos de error:

5 Llamada a procedimiento no válida

53 Archivo no encontrado

### Ejemplo:

    Sub ExampleDir
    ' Muestra todos los archivos y directorios
    Dim sPath As String
    Dim sDir As String, sValue As String
        sDir="Directorios:"
        sPath = CurDir
        sValue = Dir$(sPath + getPathSeparator + "*",16)
        Do
            If sValue <> "." And sValue <> ".." Then
                If (GetAttr( sPath + getPathSeparator + sValue) And 16) >0 Then
                    ' Obtener los directorios
                    sDir = sDir & chr(13) & sValue
                End If
            End If
            sValue = Dir$
        Loop Until sValue = ""
        MsgBox sDir,0,sPath
    End Sub

Temas relacionados

CurDir Function

Función CompatibilityMode()

Instrucción Option VBASupport