Dir Function

Tagastab faili või kataloogi nime või kõigi kettal või kataloogis olevate määratud otsinguteele vastavate failide või kataloogide nimed.

SĂĽntaks:


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

Tagastusväärtus:

String

Parameetrid:

Text: suvaline stringavaldis, mis määrab otsingutee, kataloogi või faili. Selle argumendi saad määrata ainult funktsiooni Dir esmakordsel kutsumisel. Soovi korral saad tee sisestada URLi tähistusse.

Attrib: suvaline täisarvavaldis, mis määrab bitipõhised failiatribuudid. Funktsioon Dir tagastab ainult failid või kataloogid, mis vastavad määratud atribuutidele. Mitme atribuudi kombineerimiseks kasuta atribuudiväärtusi.

0 : Tavalised failid.

16 : Tagastab ainult kataloogi nime.

Selle atribuudi abil saad kontrollida, kas fail või kataloog on olemas, või määrata kindla kataloogi kõik failid ja kaustad.

Faili olemasolu kontrollimiseks sisesta faili täielik tee ja nimi. Kui faili või kataloogi nime pole olemas, siis tagastab funktsioon Dir nullpikkusega stringi ("").

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).

Error codes:

5 Vigane protseduuri väljakutse

53 Faili ei leitud

Näide:


Sub ExampleDir
REM Kuvab kõiki faile ja katalooge
Dim sPath As String
Dim sDir As String, sValue As String
    sDir="Kataloogid:"
    sPath = CurDir
    sValue = Dir$(sPath + getPathSeparator + "*",16)
    Do
        If sValue <> "." And sValue <> ".." Then
            If (GetAttr( sPath + getPathSeparator + sValue) And 16) >0 Then
                REM Kataloogide hankimine
                sDir = sDir & chr(13) & sValue
            End If
        End If
        sValue = Dir$
    Loop Until sValue = ""
    MsgBox sDir,0,sPath
End Sub